Weather MCP

🚀 天氣 MCP 服務

本項目是一個基於 Model Control Protocol (MCP) 的天氣信息服務，能提供天氣預報和警報查詢功能，助力用戶及時掌握天氣動態。

🚀 快速開始

本服務可讓你輕鬆獲取美國各州的天氣警報以及特定經緯度位置的天氣預報。下面為你介紹具體的啟動步驟。

✨ 主要特性

• 天氣警報查詢：通過 get_alerts 方法，可獲取美國各州的天氣警報。
• 天氣預報查詢：利用 get_forecast 方法，能通過經緯度查詢特定位置的天氣預報。

📦 安裝指南

克隆倉庫

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

創建虛擬環境

# 使用 Python 標準庫
python -m venv weather_venv

# 激活虛擬環境（Windows）
weather_venv\Scripts\activate

# 激活虛擬環境（Linux/Mac）
source weather_venv/bin/activate

安裝依賴

pip install -r requirements.txt

配置環境變量

• 創建 .env 文件，參考 .env.example 文件格式。
• 添加必要的 API 密鑰。

💻 使用示例

基礎用法

啟動 Weather 服務器

python weather/weather.py

服務器將在 http://localhost:8000 上啟動，使用 SSE 傳輸。

運行客戶端

在另一個終端窗口中運行：

python weather/mcp_client.py

客戶端將連接到服務器並執行一系列天氣查詢測試。

📚 詳細文檔

API 功能

天氣警報查詢

get_alerts(state: str) -> str

• state：兩字母美國州代碼（例如：CA, NY）
• 返回：該州的活躍天氣警報列表

天氣預報查詢

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

• latitude：位置緯度
• longitude：位置經度
• 返回：該位置的天氣預報

項目結構

weather-mcp/
├── weather/
│ ├── weather.py # 主服務器文件
│ ├── mcp_client.py # 客戶端測試文件
├── requirements.txt # 項目依賴
├── .env.example # 環境變量示例
└── README.md # 本文檔

環境變量配置

項目使用 .env 文件存儲環境變量和敏感信息。請按照以下步驟設置：

複製環境變量模板文件

cp .env.example .env

編輯 .env 文件

編輯 .env 文件，填入您的實際配置。

🔧 技術細節

本項目採用了以下技術棧：

• Python 3.11+
• MCP (Model Control Protocol)
• FastMCP 服務器
• LangGraph + LangChain
• SSE (Server-Sent Events) 傳輸

這些技術的結合，使得項目能夠高效、穩定地運行，為用戶提供準確的天氣信息服務。