MCP Weather Server Rfw

🚀 MCP 天氣服務器

MCP 天氣服務器是一個基於模型上下文協議（MCP）構建的天氣服務應用程序。它能為用戶提供即時天氣數據和警報訪問，是天氣相關應用的有力基礎。

🚀 快速開始

先決條件

• Node.js (v18 或更高版本)
• npm 或 yarn 包管理器

安裝步驟

# 克隆倉庫
git clone https://github.com/cskiro/MCP-Weather-Server.git

# 切換到項目目錄
cd MCP-Weather-Server

# 安裝依賴項
npm install

# 構建項目
npm run build

# 設置 CLI 工具為可執行文件
chmod +x build/index.js

# 全局安裝（可選）
npm install -g .

使用方法

有兩種方式可以使用此服務器：

1. 直接調用：

weather

2. 通過 MCP 兼容客戶端/助手： 配置你的 MCP 客戶端以使用天氣工具進行預報和天氣警報的查詢。

✨ 主要特性

• 美國天氣預報：可通過經緯度參數，獲取任意美國位置的詳細天氣預報數據。
• 天氣警報：能查詢指定美國州內的活躍天氣警報。
• MCP 集成：作為 MCP 服務器構建，可實現與 AI 助手的無縫集成。
• 命令行界面：簡單安裝，是易於運行的 CLI 工具。

🏗️ 架構

該應用基於模型上下文協議（MCP）框架構建：

1. MCP 服務器層：負責與 MCP 客戶端之間的通信。
2. 天氣工具：實現預報和警報功能模塊。
3. 外部 API 集成：連接至國家氣象局（NWS）API。

組件結構

服務器包含兩個主要的天氣工具：

• get-forecast：根據經緯度參數獲取指定位置的詳細天氣預報。
• get-alerts：根據州名參數獲取指定區域內的活躍天氣警報。

這些工具通過與國家氣象局 API 的交互，提供可靠的數據支持。

🔧 技術細節

本項目使用的技術棧如下：

• Node.js
• TypeScript
• MCP SDK (@modelcontextprotocol/sdk)
• 國家氣象局（NWS）API
• Zod（用於輸入驗證）

💻 使用示例

基礎用法

獲取天氣預報

// 示例：獲取舊金山的天氣預報
{
  經緯度: {
    緯度: 37.7749,
    經度: -122.4194
  }
}

獲取天氣警報

// 示例：查詢加利福尼亞州的天氣警報
{
  州: "CA"
}

📚 詳細文檔

數據來源

此服務器使用 國家氣象局 API，該數據源為美國提供官方天氣信息。由於數據源限制，目前僅支持美國境內的位置查詢。

貢獻指南

歡迎任何貢獻！請隨時通過 Pull Request 提交代碼或建議。

📄 許可證

此項目採用 ISC 許可證，具體內容請查閱 LICENSE 文件。