Jackkuo666 Weather MCP Server

🚀 天氣 MCP 服務器

這是一個藉助國家氣象局（NWS）API 來提供天氣信息的模型上下文協議（MCP）服務器。它能讓你輕鬆獲取美國特定州的天氣警報，以及特定經緯度位置的天氣預報。

🚀 快速開始

本服務器使用國家氣象局（NWS）API 提供天氣信息，你可以獨立運行它，也可以將其集成到 Cline 中使用。下面為你詳細介紹使用步驟。

✨ 主要特性

• 獲取某個美國州的天氣警報。
• 根據經緯度獲取特定位置的天氣預報。

📦 安裝指南

克隆倉庫

首先，你需要克隆此倉庫到本地。

設置虛擬環境

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

安裝所需的包

使用 uv 安裝所需的包：

uv add "mcp[cli]" httpx

配置文件

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

你可以根據需要在 config.py 文件中修改這些設置。

💻 使用示例

獨立運行服務器

要獨立運行服務器，你需要先激活虛擬環境（如果尚未激活）：

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

然後運行服務器：

python weather.py

與 Cline 集成

天氣 MCP 服務器已添加到 Cline 配置中。要在 Cline 內部使用它，你需要確保 Cline 已正確安裝並運行。之後，天氣 MCP 服務器將作為工具“weather”可用。

你可以在 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 文檔以獲取最新使用說明。

🔧 技術細節

服務器包含改進的錯誤處理和日誌記錄功能。如果在請求期間發生錯誤，服務器將記錄該錯誤並返回適當的錯誤消息。日誌將以配置的日誌級別和格式打印到控制檯。

📚 詳細文檔

測試

單元測試

要運行單元測試：

python -m unittest test_weather.py

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

手動測試

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

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

# 獲取舊金山的預報
result = await mcp.call_tool("get_forecast", latitude=37.7749, longitude=-122.4194)
print(result)

貢獻

我們歡迎社區對這個項目的貢獻！如果您有任何問題、建議或功能請求，請隨時提出問題。

📄 許可證

本項目受 [LICENSE] 許可證的約束。請參考倉庫中的許可證文件以獲取詳細信息。