Weather MCP Server Y38

🚀 天氣 MCP 服務器

本項目是一個基於模型上下文協議（MCP）構建的服務器，藉助國家氣象局（NWS）API 為用戶提供精準的天氣信息。

✨ 主要特性

• 可獲取美國某州的天氣警報。
• 能依據緯度和經度獲取特定位置的天氣預報。

📦 安裝指南

環境需求

• Python 3.10+
• FastMCP
• httpx

安裝步驟

1. 克隆此倉庫。
2. 設置虛擬環境：

   python -m venv .venv
   source .venv/bin/activate  # 在 Windows 上，使用 `.venv\Scripts\activate`
   

3. 使用 uv 安裝所需的包：

   uv add "mcp[cli]" httpx
   

📚 詳細文檔

配置說明

服務器使用配置文件 config.py，其中包含以下重要設置：

您可在 config.py 文件中修改這些設置，從而自定義服務器行為。

使用說明

作為獨立服務器運行

若要獨立運行服務器，可按以下步驟操作：

1. 若尚未激活虛擬環境，請先激活：

   source .venv/bin/activate  # 在 Windows 上，使用 `.venv\Scripts\activate`
   

2. 運行服務器：

   python weather.py
   

與 Cline 結合使用

天氣 MCP 服務器已添加到 Cline 配置中。在 Cline 中使用它的步驟如下：

1. 確保 Cline 已正確設置並運行。
2. 天氣 MCP 服務器將作為工具“weather”可用。
3. 您可以在 Cline 中使用以下工具：
   • get_alerts(state: str)：獲取美國某州的天氣警報（使用兩個字母的狀態代碼，例如“CA”表示加利福尼亞）
   • get_forecast(latitude: float, longitude: float)：根據緯度和經度獲取特定位置的天氣預報

在 Cline 中使用的示例：

# 獲取加利福尼亞州的警報
result = await mcp.call_tool("weather.get_alerts", state="CA")
print(result)

# 獲取舊金山的預報（近似座標）
result = await mcp.call_tool("weather.get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

⚠️ 重要提示

在 Cline 中調用 MCP 工具的具體語法可能會因您的 Cline 設置而有所不同。請參考 Cline 文檔獲取最新使用說明。

錯誤處理和日誌記錄

服務器對 API 請求的錯誤處理和日誌記錄功能進行了改進。若請求過程中發生錯誤，服務器會記錄錯誤並返回適當的錯誤消息。日誌將按配置的日誌級別和格式輸出到控制檯。

測試說明

單元測試

要運行單元測試，可執行以下命令：

python -m unittest test_weather.py

這些測試涵蓋了 get_alerts 和 get_forecast 工具的基本功能。

手動測試

手動測試服務器時，您可以使用 MCP 客戶端調用提供的工具。以下是一些示例命令：

# 獲取加利福尼亞州的警報
result = await mcp.call_tool("weather.get_alerts", state="CA")
print(result)

# 獲取舊金山的預報（近似座標）
result = await mcp.call_tool("weather.get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

📄 許可證

文檔中未提及許可證相關信息。

👥 貢獻者

• [您的姓名]