Multi Server MCP Example

增强型多服务器MCP示例

这是多服务器MCP（模型上下文协议）客户端的增强版本，它结合了WeatherAssistant和任务管理系统的功能。客户端同时连接到多个MCP服务器，并为天气信息、任务管理等提供统一的接口。

特性

天气能力

• 综合天气数据：当前状况、每小时预报（48小时）、每日预报（8天）、天气警报
• 位置支持：带有可选国家代码的城市名称（例如“英国伦敦”）
• 天气比较：使用提示比较多个位置之间的天气
• 详细信息：紫外线指数、能见度、风速、湿度、压力等

任务管理

• 持久任务列表：添加和管理跨会话持续的任务
• 任务操作：添加新任务，列出现有任务
• 资源访问：访问会议笔记和组织资源

增强的客户端功能

• 多服务器支持：无缝连接到多个MCP服务器
• 提示系统：从任何连接的服务器访问并执行提示
• 资源管理：从不同服务器加载和处理资源
• 智能错误处理：通过用户友好的消息进行全面的错误处理
• 环境配置：通过环境变量实现安全的API密钥管理

设置

1.安装依赖项

pip install -r requirements.txt

2.配置环境变量

复制示例环境文件并配置API密钥：

cp .env.example .env

编辑 .env 使用API密钥：

GOOGLE_GEMINI_API_KEY=your_google_gemini_api_key_here
OPENWEATHERMAP_API_KEY=your_openweathermap_api_key_here

3.获取API密钥

Google Gemini API密钥

1. 访问 谷歌人工智能工作室
2. 创建新的API密钥
3. 将其添加到您的 .env 文件

OpenWeatherMap API密钥

1. 注册地址： 开放天气地图
2. 订阅“One Call by Call”以获取完整的天气功能
3. 将API密钥添加到 .env 文件

用法

启动客户端

python mcp_client.py

可用命令

天气命令

What's the weather in London?
Compare weather between New York and London
Get a 3-day forecast for Tokyo

任务管理命令

Add task "Buy groceries"
List my tasks
Add task "Finish the report by Friday"

系统命令

/prompts                                        - List all available prompts
/prompt  
 "args"...  - Execute a specific prompt
/resources                                      - List all available resources  
/resource            - Load a resource
exit/quit/q                                     - Quit the application

交互示例

天气示例

You: What's the weather in Paris?
AI: The weather in Paris, France is currently...

You: /prompt weather compare_weather_prompt "London" "Tokyo"
AI: [Executes weather comparison prompt]

You: /resource weather file://delivery_log
Resource loaded. What should I do with this content? > Analyze delivery locations for weather patterns

任务管理示例

You: Add a task to finish the quarterly report
AI: Task 'finish the quarterly report' was added successfully.

You: What are my current tasks?
AI: Here are your current tasks: [lists all tasks]

You: /resource tasks file://meeting_notes
Resource loaded. What should I do with this content? > Extract action items and add them as tasks

服务器架构

已连接的服务器

1. 天气服务器 (weather_mcp_server.py)

- OpenWeatherMap One Call API 3.0集成 - 综合气象数据检索 - 天气比较提示 - 交付日志和索引资源

1. 任务服务器 (tasklist_mcp_server.py)

- 持久任务存储在 tasks.txt - 任务添加和列表功能 - 会议笔记资源访问

服务器配置

客户端使用中的配置自动连接到两个服务器 server_configs:

• 天气：处理与天气有关的操作
• 任务：管理与任务相关的操作

高级功能

提示系统

访问特定于服务器的增强功能提示：

/prompts                                    # List all available prompts
/prompt weather compare_weather_prompt "NYC" "LA"  # Execute weather comparison

资源管理

加载和处理各种资源：

/resources                                  # List all resources
/resource weather file://delivery_log      # Load delivery log
/resource tasks file://meeting_notes       # Load meeting notes

上下文管理

客户端在交互中维护对话上下文，允许后续问题和复杂的多步骤操作。

错误处理

增强的客户端包括全面的错误处理功能，用于：

• 网络连接问题
• API密钥身份验证问题
• 命令或参数无效
• 服务器通信失败
• 资源访问错误

文件结构

multi-server-mcp-example/
├── mcp_client.py                  # Enhanced multi-server client
├── weather_mcp_server.py          # Weather MCP server
├── tasklist_mcp_server.py         # Task management MCP server
├── requirements.txt               # Python dependencies
├── .env.example                   # Environment variable template
├── .env                          # Your API keys (create from .env.example)
├── tasks.txt                     # Persistent task storage (auto-created)
└── README.md                     # This file

贡献

此增强版本汇集了以下最佳功能：

• WeatherAssistant单服务器实现
• 任务管理能力
• 多服务器架构
• 增强的错误处理和用户体验

您可以通过添加更多服务器或功能来扩展此示例！

故障排除

常见问题

1. 导入错误：确保所有依赖项都已安装 pip install -r requirements.txt
2. API关键问题：验证API密钥是否在中正确设置 .env 文件
3. 服务器连接：检查服务器文件是否与客户端位于同一目录中
4. Weather API订阅：确保您已订阅OpenWeatherMap的“一次通话”

获取帮助

如果您遇到问题：

1. 检查控制台中的错误消息
2. 验证您的API密钥和网络连接
3. 确保所有依赖项都已正确安装
4. 检查服务器日志以获取详细的错误信息