README - 🌐 Claude MCP Server Quickstart by gabrieldsguilherme

🌐 Claude MCP Server Quickstart

A ready-to-use implementation of the Model Context Protocol (MCP) server that integrates with Claude AI models.

🔍 Overview

This project provides a fully functional MCP server implementation that allows you to:

Connect Claude AI models through a standardized protocol
Process context-aware requests
Handle model responses efficiently
Streamline AI integrations in your applications

Built following the official MCP Server Quickstart guide.

✨ Features

✅ Complete MCP protocol implementation
✅ Claude AI model integration
✅ Context-aware request processing
✅ Streaming response support
✅ Easy configuration and setup
✅ Well-documented codebase

📋 Prerequisites

Python 3.8+
Access to Claude AI API credentials
Basic understanding of REST APIs

🚀 Installation

# Clone the repository
git clone https://github.com/gabrieldsguilherme/mcp-server.git
cd mcp-server

# Create and activate virtual environment
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx

⚙️ Configuration

1. Open your Claude Desktop configuration file

Open your Claude for Desktop App configuration at ~/Library/Application Support/Claude/claude_desktop_config.json in a text editor. Make sure to create the file if it doesn’t exist.

2. Update your Claude Desktop configuration file

{
    "mcpServers": {
        "weather": {
            "command": "/ABSOLUTE/PATH/TO/PARENT/FOLDER/uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "weather.py"
            ]
        }
    }
}

This tells Claude for Desktop:

a. There’s an MCP server named “weather”

b. To launch it by running uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather.py

mcp-server