MCP 天气 SSE 服务器

一个模型上下文协议 (MCP) 服务器，通过服务器发送事件 (SSE) 连接到 OpenWeatherMap API。此服务器为 Claude、CursorAI 或 MCP-Inspector 等 AI 客户端提供实时天气数据。

特性

• 实现模型上下文协议，与 AI 工具无缝集成
• 使用服务器发送事件 (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  # 在 Windows 上：venv\Scripts\activate
   pip install mcp requests
   

用法

启动服务器

您可以使用您的 OpenWeatherMap API 密钥启动服务器：

# 使用命令行参数
python mcp_weather_sse.py --api-key YOUR_API_KEY

# 使用环境变量
export OPENWEATHER_API_KEY=YOUR_API_KEY
python mcp_weather_sse.py

# 自定义主机和端口（默认：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. 输入以下详细信息：
   • Name: Weather SSE
   • Type: 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. "What's the current weather in New York?" (纽约现在天气怎么样？)
2. "Can you give me a 3-day forecast for Tokyo?" (你能给我东京未来三天的天气预报吗？)
3. "What's the weather at coordinates 40.7128, -74.0060?" (坐标 40.7128, -74.0060 的天气怎么样？)

API 参考

get_current_weather

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

参数：

• city (string)：城市名称（例如，“London”、“New York”）
• units (string, optional)：测量单位（“metric”或“imperial”，默认值：“metric”）

get_weather_forecast

获取城市的多日天气预报。

参数：

• city (string)：城市名称（例如，“London”、“New York”）
• days (integer, optional)：要预测的天数（1-5，默认值：3）
• units (string, optional)：测量单位（“metric”或“imperial”，默认值：“metric”）

get_weather_by_coordinates

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

参数：

• latitude (number)：纬度坐标
• longitude (number)：经度坐标
• units (string, optional)：测量单位（“metric”或“imperial”，默认值：“metric”）

安全注意事项

• 默认情况下，服务器绑定到 127.0.0.1，使其只能从您的本地计算机访问
• 对于生产用途，请实施适当的身份验证和 HTTPS
• 考虑速率限制以避免超出 OpenWeatherMap API 配额

许可证

MIT

致谢

• 使用 模型上下文协议 构建
• 使用来自 OpenWeatherMap API 的数据