MCP Weather Server

🚀 天氣 MCP 服務器

本項目是一個 MCP（模型上下文協議）服務器，用於訪問美國國家氣象局（NWS）API 的 US 天氣數據。它提供了便捷的工具，可獲取任意美國州份的天氣警報與預測。

🚀 快速開始

此服務器通過標準輸入輸出運行，以確保與 MCP 客戶端的兼容性。運行服務器的命令如下：

python weather.py

✨ 主要特性

• 可依據兩個字母的州代碼，獲取任意美國州的天氣警報。
• 藉助緯度和經度，獲取詳細的天氣預報。
• 具備結構化日誌記錄功能，附帶上下文信息。
• 支持錯誤處理和超時管理。

📦 安裝指南

通過 Smithery 安裝

若要藉助 Smithery 自動將 mcp-weather-server 安裝到 Claude Desktop，可使用以下命令：

npx -y @smithery/cli install @asifdotpy/mcp-weather-server --client claude

手動安裝

# 克隆倉庫
git clone <repository-url>

# 進入目錄
cd weather

# 安裝依賴項（需要 Python 3.11+）
pip install -e .

📚 詳細文檔

依賴

• httpx：用於進行異步 HTTP 請求。
• mcp：構建 MCP 服務器的模型上下文協議庫。

使用方法

該服務器提供了兩個主要工具：

獲取天氣警報

get_alerts(state: str) -> str

• state：美國州代碼，兩個字母（例如 CA、NY）。
• 返回指定州的格式化天氣警報信息。

獲取天氣預報

get_forecast(latitude: float, longitude: float) -> str

• latitude：位置緯度。
• longitude：位置經度。
• 返回指定座標點的 5 時段天氣預報。

開發

• 設置 ENV 環境變量為 "production" 以獲得 JSON 格式的日誌。
• 使用 LOG_LEVEL 環境變量配置日誌級別。

📄 許可證

[在此處指定你的許可證信息]