Weather MCP

🚀 Weather MCP 🌤️

Weather MCP 是一款基於多雲平臺（MCP）構建的現代天氣服務，可提供實時天氣數據和預警信息。

🚀 快速開始

前提條件

• Node.js（v18 或更高版本）
• MCP 服務器
• Git

安裝步驟

1. 克隆倉庫：

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

2. 安裝依賴並構建項目：

npm install && npm run build

✨ 主要特性

• 🌡️ 實時天氣預報
• ⚠️ 按州發佈的天氣預警
• 📍 基於位置的天氣信息
• 🔄 易於使用的 API 端點

💻 使用示例

基礎用法

在 Cursor IDE 中配置並啟動 MCP 服務器後，你可以使用自然語言查詢與天氣服務進行交互。以下是一些示例查詢：

• "What's the weather in Sacramento?"（薩克拉門託的天氣如何？）
• "Are there any active weather alerts in Texas?"（得克薩斯州有正在生效的天氣預警嗎？）
• "What's the forecast for San Francisco?"（舊金山的天氣預報如何？）
• "Show me weather alerts for CA"（給我看看加利福尼亞州的天氣預警）

注意：由於此服務使用美國國家氣象局 API，查詢僅適用於美國境內的位置。

高級用法

當你發起查詢時，系統會按以下步驟處理：

1. 你的問題會被髮送到大型語言模型（LLM）。
2. LLM 會分析可用的工具並決定使用哪些工具。
3. 客戶端通過 MCP 服務器執行所選工具。
4. 結果會被髮送回 LLM。
5. 系統會生成自然語言響應並展示給你。

常見問題排查

如果工具無法按預期工作，請按以下步驟操作：

• 驗證服務器構建和運行是否沒有錯誤。
• 檢查 .cursor/mcp.json 中的路徑是否正確且為絕對路徑。
• 如有必要，重啟 Cursor IDE。
• 由於該服務僅支持美國境內的位置，查詢美國境外的座標會收到錯誤信息。
• 在高流量期間，天氣服務 API 可能會有速率限制。

🤝 貢獻代碼

歡迎貢獻代碼！請隨時提交拉取請求。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。