MCP Weather

🚀 MCP 天氣

MCP 天氣是一個基於模型控制協議（MCP）框架構建的天氣信息服務，它能讓用戶便捷地訪問國家氣象局（NWS）的數據，為獲取即時天氣信息提供了高效的解決方案。

🚀 快速開始

MCP 天氣是一個 Python 應用程序，作為 MCP 工具運行，可讓 AI 助手從國家氣象局 API 獲取即時天氣信息。該服務具備兩大核心功能：一是獲取任何美國州的活躍天氣警報；二是獲取特定位置的詳細天氣預報。

✨ 主要特性

• 可通過 US 狀態代碼檢索活躍天氣警報。
• 能獲取特定位置的詳細天氣預報。
• 輸出清潔、格式化，便於閱讀。
• 作為 MCP 工具構建，可與 AI 助手無縫集成。

📦 安裝指南

環境要求

• Python 3.13 或更高版本。
• 依賴項：
  • httpx
  • mcp[cli]

安裝步驟

1. 克隆此倉庫：

   git clone https://github.com/jpan8866/mcp-weather.git
   cd mcp-weather
   

2. 使用 python 包管理器 uv 來運行服務器：

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

💻 使用示例

作為 MCP 服務運行

基礎用法

要測試服務器，請運行：

uv 運行 weather.py

高級用法

如果服務器成功啟動且無錯誤，您可以使用以下命令使工具可用：

PATH/uv --directory 絕對路徑/mcp-weather 運行 weather.py

可用工具

獲取天氣警報

檢索指定美國州的活躍天氣警報。

獲取天氣預報

檢索特定位置的詳細天氣預報。

📚 詳細文檔

該應用程序使用 國家氣象局 API 來獲取天氣數據。

🤝 貢獻

歡迎貢獻！請隨意提交拉取請求。

🙏 致謝

• 國家氣象局，感謝提供天氣數據 API。
• MCP 框架，感謝支持 AI 工具集成。
• 文檔：模型上下文協議