MCP Weather SSE Server

MCP Weather SSE Server

site icon
2025.04.15 0
Python天气服务实时数据位置服务
MCP Weather SSE Server 是一个基于 Model Context Protocol (MCP) 的服务,通过 Server-Sent Events (SSE) 与 OpenWeatherMap API 连接,为 AI 客户端(如 Claude、CursorAI 或 MCP-Inspector)提供实时天气数据。该服务具有实时通信能力,支持获取当前天气、多日天气预报以及基于地理坐标的天气信息。
View on GitHub

Overview

基本能力

产品定位

MCP Weather SSE Server 是一个实时天气数据服务,专为 AI 工具和客户端设计,提供无缝的天气数据集成。

核心功能

  • 实现 Model Context Protocol,便于与 AI 工具集成
  • 使用 Server-Sent Events (SSE) 进行实时通信
  • 连接 OpenWeatherMap API 获取实时天气数据
  • 提供三种工具:
  • get_current_weather:获取城市的当前天气状况
  • get_weather_forecast:获取城市的多日天气预报
  • get_weather_by_coordinates:获取特定地理坐标的天气信息

适用场景

  • AI 客户端需要实时天气数据的场景
  • 需要集成天气信息的开发项目
  • 实时天气监控和分析

工具列表

  1. get_current_weather:获取城市的当前天气状况,支持单位和城市名称参数。
  2. get_weather_forecast:获取城市的多日天气预报,支持天数、单位和城市名称参数。
  3. get_weather_by_coordinates:获取特定地理坐标的天气信息,支持单位和坐标参数。

常见问题解答

  • 安全性:默认绑定到 127.0.0.1,仅本地可访问;生产环境需实现认证和 HTTPS。
  • API 配额:需考虑速率限制以避免超出 OpenWeatherMap API 配额。

使用教程

使用依赖

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/mcp-weather-sse.git cd mcp-weather-sse
  2. 创建虚拟环境并安装依赖: bash python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install mcp requests

调试方式

  1. 启动服务器: bash python mcp_weather_sse.py --api-key YOUR_API_KEY 或使用环境变量: bash export OPENWEATHER_API_KEY=YOUR_API_KEY python mcp_weather_sse.py
  2. 使用 MCP-Inspector 测试服务器: bash npm install -g @anthropic-ai/mcp-inspector mcp-inspector http://127.0.0.1:3001/sse
  3. 示例查询:
  4. "What's the current weather in New York?"
  5. "Can you give me a 3-day forecast for Tokyo?"
  6. "What's the weather at coordinates 40.7128, -74.0060?"

许可证

该项目遵循 MIT 开源许可条款。