Simple Weather MCP Server

🚀 天氣 MCP 服務器

這是一個簡單的 MCP（模型控制協議）服務器，藉助國家氣象局 API 來提供天氣信息。該服務器提供了兩個實用工具，能幫助用戶獲取天氣相關數據：

• get_alerts：可獲取美國某州的天氣預警。
• get_forecast：能獲取特定位置的天氣預報。

🚀 快速開始

先決條件

• 需要 Python 3.10 或更高版本。
• 推薦使用 uv 包管理器，也可以使用 pip。

📦 安裝指南

1. 克隆此倉庫：

git clone <your-repo-url>
cd simple_mcp_server

2. 配置您的 Python 環境：

• 使用 uv（推薦）：

# 如果尚未安裝 uv，請先安裝
curl -LsSf https://astral.sh/uv/install.sh | sh

# 創建並激活虛擬環境
uv venv
source .venv/bin/activate  # Windows 系統請使用：.venv\Scripts\activate

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

• 使用 pip：

python -m venv .venv
source .venv/bin/activate  # Windows 系統請使用：.venv\Scripts\activate
pip install "mcp[cli]" httpx

💻 使用示例

基礎用法

1. 運行服務器：

mcp dev main.py

2. 配置 Claude for Desktop：

• 打開您的 Claude for Desktop 應用配置文件，路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json。
• 添加以下配置：

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

• 將 /ABSOLUTE/PATH/TO/simple_mcp_server 替換為您實際項目的完整路徑。
• 保存文件並重新啟動 Claude for Desktop。

3. 測試服務器：

• 打開 Claude for Desktop。
• 查找界面中的錘子圖標。
• 您應該會看到兩個工具：get_alerts 和 get_forecast。
• 嘗試提出以下問題：
  • "NY 的天氣怎麼樣？"
  • "NY 有哪些活躍的天氣預警？"

📚 詳細文檔

可用工具

get_alerts

獲取美國某州的天氣預警。

get_forecast

獲取特定位置的天氣預報。

🔧 技術細節

故障排除

1. 如果服務器未被 Claude for Desktop 檢測到：

• 確保配置文件路徑正確。
• 驗證配置中的絕對路徑是否正確。
• 確認所有依賴項已安裝。
• 嘗試重新啟動 Claude for Desktop。

2. 如果出現天氣 API 錯誤：

• 檢查您的互聯網連接。
• 驗證座標或狀態代碼是否有效。
• 國家氣象局 API 僅適用於美國地區。