Weather MCP Server Lbv

🚀 天氣 MCP 服務器

天氣 MCP 服務器是一個提供天氣信息的模型上下文協議（MCP）服務器，它集成於桌面版的 Claude 中。該服務器藉助國家氣象局 API，能為美國境內的任意位置提供天氣預報和警報服務。此項目是作為 MIT MCP 黑客馬拉松活動的一部分於 2025 年 4 月創建的。

🚀 快速開始

本服務器集成於桌面版 Claude，藉助國家氣象局 API 為美國境內提供天氣服務。按以下步驟操作，即可快速使用：

1. 完成安裝與配置（具體步驟見後續章節）。
2. 啟動桌面版 Claude。
3. 查看錘子 🔨 圖標以確認服務器已連接。
4. 發起示例查詢，如 "Sacramento 的天氣怎麼樣？" 或 "Texas 有哪些活躍的天氣警報？"

✨ 主要特性

• get_forecast：使用經緯度獲取任何美國位置的詳細天氣預報。
• get_alerts：根據州代碼檢索特定州內的活躍天氣警報。

📦 安裝指南

配置要求

• Python 3.10 或更高版本。
• uv 包管理器。
• 桌面版 Claude。
• MCP SDK 1.2.0 或更高版本。

安裝步驟

1. 確保已安裝 uv：

curl -LsSf https://astral.sh/uv/install.sh | sh

2. 配置 Python 環境：

# 創建並激活虛擬環境
uv venv
source .venv/bin/activate

# 安裝依賴項
uv add "mcp[cli]" httpx

📚 詳細文檔

配置步驟

1. 創建或編輯桌面版 Claude 的配置文件 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "weather": {
      "command": "/path/to/uv",
      "args": [
        "--directory",
        "/absolute/path/to/weather",
        "run",
        "weather.py"
      ]
    }
  }
}

2. 將 /path/to/uv 替換為您實際的 uv 可執行文件路徑（使用 which uv 查找）。
3. 將 /absolute/path/to/weather 替換為該項目的絕對路徑。

使用方法

1. 啟動桌面版 Claude。
2. 查看錘子 🔨 圖標以確認服務器已連接。
3. 示例查詢：
   • "Sacramento 的天氣怎麼樣？"
   • "Texas 有哪些活躍的天氣警報？"

故障排除

• 檢查 Claude 的日誌文件 ~/Library/Logs/Claude/mcp*.log。
• 確保配置中的所有路徑均為絕對路徑。
• 驗證服務器是否能獨立運行（使用 uv run weather.py）。
• 確認端口 8001 沒有被其他進程佔用。

API 參考

該服務器使用國家氣象局 API：

• 基礎 URL：https://api.weather.gov
• 使用的端點：
  • /alerts/active/area/{state} - 根據州獲取警報信息。
  • /points/{lat},{lon} - 獲取預測網格數據。
  • /forecast - 獲取詳細預報。

🔧 技術細節

該項目是 MIT MCP 黑客馬拉松（2025 年 4 月）教程的一部分，旨在向開發者介紹模型上下文協議，並幫助項目或初創公司啟動自己的 MCP 服務器。該黑客馬拉松活動是 MIT 納達（NANDA，網絡化代理和分散式人工智能）樞紐計劃的一部分。

📄 許可證

該項目遵循原始教程的許可聲明：模型上下文協議