MCP Weather Sse

🚀 MCP 天氣 SSE 服務器

本項目是一個實現模型上下文協議 (MCP) 的服務器，它藉助 Server-Sent Events (SSE) 與 OpenWeatherMap API 相連，能為 Claude、CursorAI 或 MCP-Inspector 等 AI 工具提供即時天氣數據，助力 AI 工具實現更智能的交互。

🚀 快速開始

本服務器可快速為 AI 工具提供即時天氣數據。你只需完成安裝步驟並啟動服務器，即可與各類 AI 工具進行連接。

✨ 主要特性

• 無縫集成：實現模型上下文協議，可與 Claude、CursorAI 等 AI 工具無縫集成。
• 即時通信：採用 Server-Sent Events (SSE) 傳輸協議，實現與 AI 工具的即時數據通信。
• 數據獲取：連接到 OpenWeatherMap API，獲取全球各地的即時天氣數據。
• 豐富工具：提供三種實用工具，滿足不同場景下的天氣數據需求。
  • get_current_weather：獲取指定城市的當前天氣狀況。
  • get_weather_forecast：獲取指定城市的多日天氣預報。
  • get_weather_by_coordinates：根據地理座標獲取天氣信息。

📦 安裝指南

先決條件

• Python 3.8 及以上版本。
• 你需要在 openweathermap.org 註冊獲取 OpenWeatherMap API 密鑰。

安裝步驟

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
   

💻 使用示例

啟動服務器

你可以通過以下幾種方式啟動服務器：

使用命令行參數

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. 轉到 文件 → 偏好設置 → Cursor 設置 → MCP → 添加新服務器。
3. 輸入以下信息：
   • 名稱：天氣 SSE
   • 類型：sse
   • URL：http://127.0.0.1:3001/sse

Claude Desktop

1. 打開 Claude Desktop。
2. 轉到 設置 → MCP 服務器。
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

📚 詳細文檔

API 參考

get_current_weather

獲取指定城市的當前天氣信息。

請求

GET /weather/current?city={city}

響應

{
  "temperature": {number},
  "condition": {string},
  "humidity": {number},
  "windSpeed": {number}
}

get_weather_forecast

獲取指定城市的多日天氣預報。

請求

GET /weather/forecast?city={city}&days={days}

響應

[
  {
    "date": "{date}",
    "temperature": {number},
    "condition": {string},
    "humidity": {number},
    "windSpeed": {number}
  },
  ...
]

get_weather_by_coordinates

根據經緯度獲取天氣信息。

請求

GET /weather/coordinates?lat={latitude}&lon={longitude}

🔧 技術細節

本服務器基於 Python 構建，使用了 mcp 和 requests 庫。通過實現模型上下文協議 (MCP) 和 Server-Sent Events (SSE) 協議，實現與 AI 工具的即時通信。同時，通過調用 OpenWeatherMap API 獲取即時天氣數據。

⚠️ 重要提示

• 確保 OpenWeatherMap API 密鑰的安全性，避免在代碼中明文存儲。建議使用環境變量或配置文件來管理 API 密鑰。
• 在生產環境中，建議使用 HTTPS 協議傳輸數據，以確保數據的安全性和完整性。