MCP Server Weather Alerts

🚀 MCP 天氣服務器

本項目是一個基於 MCP（模型上下文協議）框架搭建的天氣服務器。它藉助美國國家氣象局（NWS）API，提供了獲取美國特定位置天氣警報和預報的工具，為用戶瞭解當地天氣情況提供便利。

🚀 快速開始

啟動服務器

運行 MCP 天氣服務器：

python weather.py

若服務器和客戶端在同一臺機器上，使用 stdio 傳輸：

uv run weather.py

✨ 主要特性

• 獲取天氣警報：可檢索特定美國州的活躍天氣警報。
• 獲取天氣預報：能獲取特定緯度和經度位置的詳細天氣預報。

📦 安裝指南

1. 克隆倉庫：

   git clone <repository-url>
   

2. 進入項目目錄：

   cd MCP Server/weather
   

3. 安裝依賴項：

   pip install -r requirements.txt
   

💻 使用示例

基礎用法

1. 獲取天氣警報

使用 get_alerts 工具獲取特定美國州的活躍天氣警報。 參數：

• state：兩位字母的美國州代碼（例如，CA 表示加利福尼亞，NY 表示紐約）。 示例：

{
  "tool": "get_alerts",
  "args": {
    "state": "CA"
  }
}

2. 獲取天氣預報

使用 get_forecast 工具獲取特定位置的詳細天氣預報。 參數：

• latitude：位置的緯度（例如，34.0522 表示洛杉磯）。
• longitude：位置的經度（例如，-118.2437 表示洛杉磯）。 示例：

{
  "tool": "get_forecast",
  "args": {
    "latitude": 34.0522,
    "longitude": -118.2437
  }
}

高級用法

這些工具設計為由語言模型（LLM）通過客戶端自動調用，當需要時與服務器交互以獲取天氣警報或預報。

🤝 貢獻

歡迎提交問題或拉取請求來改進該項目。

📄 許可證

此項目遵循 MIT 許可證。