MCP Client & Server Example

Name: MCP Client & Server Example
Author: xiaoye-hua

@xiaoye-hua

Repository

About MCP Client & Server Example

No overview available yet

#mcp #client #server #example

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp_server_client_example": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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).