MCP Weather SSE Server

MCP Weather SSE Server

一个通过 Server-Sent Events（SSE）连接 OpenWeatherMap API 的 Model Context Protocol（MCP）服务。此服务为 Claude、CursorAI 或 MCP-Inspector 等 AI 客户端提供实时天气数据。

功能

• 实现 Model Context Protocol，轻松集成 AI 工具
• 使用 Server-Sent Events（SSE）传输方式进行实时通信
• 连接 OpenWeatherMap API 以获取实时天气数据
• 提供三个工具：
  • get_current_weather：获取某个城市的当前天气状况
  • get_weather_forecast：获取某个城市未来多天的天气预报
  • get_weather_by_coordinates：获取指定地理坐标的天气

先决条件

• Python 3.8+
• OpenWeatherMap API 密钥（在 openweathermap.org 注册）

安装

1. 克隆此仓库：

   git clone https://github.com/yourusername/mcp-weather-sse.git
   cd mcp-weather-sse
   

2. 创建虚拟环境并安装依赖项：

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate
   pip install mcp requests
   

使用方法

启动服务

你可以使用 OpenWeatherMap API 密钥启动服务：

# Using command line argument
python mcp_weather_sse.py --api-key YOUR_API_KEY

# Using environment variable
export OPENWEATHER_API_KEY=YOUR_API_KEY
python mcp_weather_sse.py

# Customize host and port (default: 127.0.0.1:3001)
python mcp_weather_sse.py --host 0.0.0.0 --port 8080

连接 MCP 客户端

Cursor AI

1. 打开 Cursor AI
2. 前往 File → Preferences → Cursor Settings → MCP → Add New Server
3. 输入以下信息：
   • 名称：Weather SSE
   • 类型：sse
   • URL：http://127.0.0.1:3001/sse

Claude Desktop

1. 打开 Claude Desktop
2. 前往 Settings → MCP Servers
3. 使用以下配置添加新服务：

   {
     "mcpServers": {
       "weather": {
         "type": "sse",
         "url": "http://127.0.0.1:3001/sse"
       }
     }
   }
   

MCP-Inspector

你可以使用 MCP-Inspector 工具测试你的服务：

npm install -g @anthropic-ai/mcp-inspector
mcp-inspector http://127.0.0.1:3001/sse

查询示例

连接后，你可以使用以下查询与服务交互：

1. “纽约当前天气怎么样？”
2. “能告诉我东京未来 3 天的天气预报吗？”
3. “坐标 40.7128, -74.0060 处的天气怎么样？”

API 参考

get_current_weather

获取某个城市的当前天气状况。

参数：

• city（字符串）：城市名称（例如，'London'、'New York'）
• units（字符串，可选）：测量单位（'metric' 或 'imperial'，默认值：'metric'）

get_weather_forecast

获取某个城市未来多天的天气预报。

参数：

• city（字符串）：城市名称（例如，'London'、'New York'）
• days（整数，可选）：预报天数（1-5，默认值：3）
• units（字符串，可选）：测量单位（'metric' 或 'imperial'，默认值：'metric'）

get_weather_by_coordinates

获取指定地理坐标的天气。

参数：

• latitude（数字）：纬度坐标
• longitude（数字）：经度坐标
• units（字符串，可选）：测量单位（'metric' 或 'imperial'，默认值：'metric'）

安全注意事项

• 服务默认绑定到 127.0.0.1，因此只能从本地计算机访问
• 用于生产环境时，请实施适当的身份验证并启用 HTTPS
• 考虑添加速率限制，以避免超出 OpenWeatherMap API 配额

许可证

MIT

致谢

• 基于 Model Context Protocol 构建
• 使用来自 OpenWeatherMap API 的数据