Weather MCP Server Tuo

🚀 模型上下文協議（MCP）天氣服務器

本項目實現了一個模型上下文協議（MCP）服務器，該服務器可讓AI助手（如Claude）與美國國家氣象局（NWS）API進行交互，從而為用戶提供指定位置的即時天氣警報和預報，極大地提升了獲取天氣信息的便捷性。

🚀 快速開始

運行本項目前，您需要完成一系列的準備工作，包括安裝必要的依賴和配置服務器。以下是詳細步驟：

先決條件

在運行本項目之前，請確保安裝了以下內容：

• Python（推薦版本3.11.6或更高）
• uv包管理器（pip install uv）
• httpx安裝（pip install httpx）
• fastmcp安裝（pip install fastmcp）
• Claude桌面應用程序

uv包管理器安裝：

# 適用於macOS和Linux。
curl -LsSf https://astral.sh/uv/install.sh | sh

# 適用於Windows。
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

將路徑添加到系統環境變量中

安裝與配置

1. 克隆倉庫：

   git clone https://github.com/ankushmehta123/weather-mcp-server.git
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 配置您的MCP服務器，將以下內容添加到 claude_desktop_config.json 文件中：

   {
    "mcpServers": {
        "weather": {
            "command": "C:/Users/your_username/.local/bin/uv.exe",
            "args": [
                "--directory",
                "main.py所在的目錄位置",
                "run",
                "main.py"
            ]
        }
    }
   }
   

使用方法

運行 main.py：

python main.py

可用的API工具

在Claude桌面應用程序中，您會看到右側搜索欄旁有2個MCP工具可用。

現在您可以向Claude提出與天氣相關的問題了。

✨ 主要特性

• 獲取特定美國州份的活躍天氣警報：用戶可以通過該服務器獲取美國特定州份當前的活躍天氣警報，及時瞭解當地的天氣異常情況。
• 拉取指定緯度和經度的天氣預報：支持根據用戶指定的緯度和經度，精準拉取當地的天氣預報信息。
• 實現FastMCP框架以公開AI交互工具：藉助FastMCP框架，將AI交互工具公開，方便用戶與服務器進行交互。

🔧 技術細節

本項目使用了以下技術來構建和運行：

• Python：作為主要的開發語言，提供了豐富的庫和工具，方便進行服務器開發和數據處理。
• FastMCP：實現了模型上下文協議（MCP），為AI助手與服務器之間的交互提供了基礎框架。
• httpx：用於異步HTTP請求，提高了服務器與美國國家氣象局（NWS）API之間的數據交互效率。