MCP Second Project Weather Forecaster

🚀 天氣MCP服務器

這是一個強大的天氣信息服務器，基於FastMCP構建，可通過多個接口提供天氣預警和相關工具。

🚀 快速開始

選項1：交互式啟動器（推薦）

python run_server.py

運行此命令後，你可以選擇啟動MCP服務器或Web界面。

選項2：直接啟動Web界面

python server/web_interface.py

然後在瀏覽器中打開：http://localhost:8000

選項3：僅啟動MCP服務器

python main.py

✨ 主要特性

• 🌤️ 天氣預警：獲取美國任何州的即時天氣預警。
• 🔊 回聲資源：具備簡單的消息回顯功能。
• 🖥️ 多接口選擇：可選擇MCP服務器或Web界面。
• 🎨 精美界面：擁有現代、響應式的Web界面。

📦 安裝指南

1. 安裝依賴項：

   uv sync
   

2. 啟動服務器：

   python run_server.py
   

💻 使用示例

Web界面

1. 啟動Web界面。
2. 在瀏覽器中打開 http://localhost:8000。
3. 使用表單進行以下操作：
   • 獲取美國某個州（如CA、NY、TX）的天氣預警。
   • 通過資源系統回顯消息。

MCP服務器

MCP服務器提供以下工具：

• get_alerts(state)：獲取美國某個州的天氣預警。
  • state：美國州的雙字母代碼（如 "CA"、"NY"）。
• echo_resource(message)：將消息作為資源進行回顯。
  • message：任何要回顯的文本消息。

📚 詳細文檔

API端點

• GET /：主Web界面。
• POST /api/alerts：獲取天氣預警（表單數據：state）。
• POST /api/echo：回顯消息（表單數據：message）。

依賴項

• mcp[cli]>=1.13.0：MCP服務器框架。
• fastapi>=0.104.0：Web框架。
• uvicorn[standard]>=0.24.0：ASGI服務器。
• httpx>=0.25.0：HTTP客戶端。
• python-multipart>=0.0.6：表單數據處理。

項目結構

secondproject/
├── main.py                 # MCP服務器入口點
├── run_server.py          # 交互式啟動器
├── server/
│   ├── weather.py         # MCP服務器實現
│   └── web_interface.py   # Web界面
├── pyproject.toml         # 項目配置
└── README.md              # 本文件

故障排除

常見問題

1. 端口已被佔用：在 web_interface.py 中更改端口或停止其他服務。
2. 缺少依賴項：運行 uv sync 安裝所有依賴項。
3. API錯誤：檢查網絡連接以獲取天氣數據。

獲取幫助

• 檢查控制檯輸出的錯誤消息。
• 確保所有依賴項已安裝。
• 驗證Python版本（需要3.12+）。

📄 許可證

本項目為開源項目，採用MIT許可證。