🌐 Claude MCP Server Quickstart
LocalAbout 🌐 Claude MCP Server Quickstart
A Python MCP server quickstart for connecting Claude models to applications. It demonstrates context-aware requests and streaming responses, with a weather example for use from Claude Desktop.
Key features
- 01Implements the MCP protocol
- 02Connects Claude models
- 03Processes context-aware requests
- 04Supports streaming responses
- 05Includes Claude Desktop setup guidance
Use cases
- 01Connect Claude Desktop to the example server
- 02Ask for weather information through Claude
MCP support
Implements an MCP server that Claude Desktop can launch and connect to. The README illustrates asking for weather information, but does not specify the server's exposed tools.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project README🌐 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
3. Save the file and restart Claude for Desktop
📖 Usage
1. Ask Claude "What’s the weather in Sacramento?"
2. Ask Claude "What are the active weather alerts in Texas?"
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.