MCP Client

MCP 客户端

一个用于与 MCP 服务交互的 Python 客户端，并以天气工具服务作为示例。客户端使用 Anthropic 的 Claude API 处理自然语言查询，并可连接任何兼容的 MCP 服务脚本。

功能

• 用于 MCP 服务的交互式聊天客户端
• 示例天气服务（server/weather.py），提供：
  • 美国各州的天气警报
  • 基于位置的天气预报（通过 NWS API）
• 可扩展：连接任何兼容 MCP 的服务脚本
• 使用 Anthropic Claude API 理解自然语言

要求

• Python 3.12+
• Anthropic API 密钥
• MCP Python 包（mcp>=1.9.2）
• uv（用于在隔离环境中运行，可选但推荐）

安装

1. 克隆仓库：

   git clone <your-repo-url>
   cd mcp-client
   

2. 安装依赖项：

   uv pip install -r requirements.txt
   

   或者，如果你使用 uv 和 pyproject.toml：

   uv pip install
   

3. 设置 Anthropic API 密钥：

   • 在项目根目录中创建一个 .env 文件：

     ANTHROPIC_API_KEY=your-anthropic-api-key-here
     

   • .env 文件已列入 .gitignore，并会自动加载。

使用方法

启动天气服务

示例天气服务位于 server/weather.py。它提供两个工具：get_alerts 和 get_forecast。

运行客户端

你可以使用以下方式将客户端连接到天气服务：

uv run client.py ./server/weather.py

或者，如果你更喜欢使用原生 Python：

python client.py ./server/weather.py

你应该会看到类似以下的输出：

Connected to server with tools: ['get_alerts', 'get_forecast']

MCP Client Started!
Type your queries or 'quit' to exit.

示例查询

• What is the weather in New York?
• Are there any weather alerts for CA?
• Give me the forecast for latitude 40.7, longitude -74.0

退出

输入 quit 退出聊天循环。

项目结构

.
├── client.py            # Main MCP client
├── server/
│   └── weather.py       # Example weather MCP server
├── pyproject.toml       # Project metadata and dependencies
├── .env                 # (Not committed) Your API keys
├── .gitignore
└── README.md

开发

• 客户端使用 python-dotenv 从 .env 加载环境变量。
• 天气服务使用美国国家气象局 API，并需要访问互联网。

故障排除

• Anthropic API 错误：
  确保你的 API 密钥有效且有足够的额度。
• Python 版本：
  项目要求 Python 3.12 或更高版本。
• 网络问题：
  天气服务需要访问 https://api.weather.gov。

许可证