Weather MCP Server Pyp

🚀 天氣 MCP 服務器

這是一個學習項目，旨在探索 Model Context Protocol (MCP) 概念。該項目實現了一個簡單的天氣服務，藉助 National Weather Service (NWS) API 提供天氣警報和預報，幫助開發者瞭解如何運用 MCP 協議。

🚀 快速開始

此項目作為學習 MCP 的練習而創建，遵循文檔： https://modelcontextprotocol.io/quickstart/server#core-mcp-concepts MCP 是一種協議，允許 AI 助手訪問外部工具和數據源。該項目展示瞭如何為 Claude 或其他與 MCP 兼容的助手創建一個 MCP 服務器。

✨ 主要特性

• get_alerts：獲取美國某州的當前天氣警報
• get_forecast：根據經緯度獲取特定位置的天氣預報

📦 安裝指南

環境需求

• Python 3.9+
• httpx 庫
• mcp 庫

安裝步驟

1. 克隆此倉庫
2. 安裝依賴項：

   pip install mcp httpx
   

   或使用 uv：

   uv pip install mcp httpx
   

3. 在您的 AI 助手中配置 MCP 服務器：
   • 在 Claude Desktop 中：在 Claude Desktop 配置中添加以下內容：

   {
     "mcpServers": {
       "weather": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
           "run",
           "weather.py"
         ]
       }
     }
   }
   

   • 在 Cursor 中：前往 Cursor 設置 -> MCP 服務器 -> 添加 MCP 服務器
     • 名稱：天氣（或其他您喜歡的名稱）
     • 類型：命令
     • 命令：uv run /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather/weather.py

💻 使用示例

基礎用法

一旦 MCP 服務器設置完成，您可以要求 AI 助手：

• "CA 現在有什麼天氣警報嗎？"
• "獲取緯度 37.7749 和經度 -122.4194 的天氣預報"

📄 許可證

本項目用於教育目的。

致謝

感謝 National Weather Service (NWS) 提供天氣數據，MCP 文檔提供實現服務器的指導。