MCP Client & Server Example

What is MCP Client & Server Example?

MCP Client & Server Example is a reference implementation of a Model Context Protocol (MCP) client and server that provides weather data using the National Weather Service API and integrates with Claude AI. It is intended for developers learning MCP or building AI-powered weather tools.

How to use MCP Client & Server Example?

Clone the repository, install uv (Python package installer), create a virtual environment, install dependencies with uv pip install -e ., copy .env.example to .env, paste your Anthropic API key, then run the server or client scripts (e.g., weather_server.py, client_example.py).

Key features of MCP Client & Server Example

• MCP server with weather service endpoints
• Interactive client with Claude AI integration
• Uses the National Weather Service API
• Python 3.12+ and uv based
• Minimal setup with .env for API key

Use cases of MCP Client & Server Example

• Learning how to implement an MCP client and server
• Prototyping a weather chatbot powered by Claude AI
• Demonstrating MCP integration with external APIs

FAQ from MCP Client & Server Example

What Python version is required?

Python 3.12 or higher is required.

What dependencies are needed?

uv (Python package installer) and an Anthropic API key stored in a .env file.

How do I install the project?

Clone the repository, run uv venv to create a virtual environment, activate it, then run uv pip install -e . to install all dependencies.

What data does the server use?

The server uses the National Weather Service API to provide weather data.

What is the project structure?

It includes weather_server.py (MCP server), client_example.py (interactive client with Claude), and weather_example.py (example using the National Weather Service).