Akaramanapp Weather MCP Server

🚀 天氣 MCP 服務器

這是一個基於模型上下文協議（MCP）的服務器，藉助國家氣象局（NWS）API，為用戶提供美國地區的天氣信息與警報。它專為 AI 代理通過模型上下文協議使用而設計，能有效滿足相關需求。

🚀 快速開始

本服務器專為 AI 代理通過模型上下文協議設計，要使用它，你需要完成以下步驟：

1. 確保滿足先決條件，即安裝 Node.js（v16 或更高版本）以及 npm 或 yarn 包管理器。
2. 按照安裝指南克隆倉庫、安裝依賴項並構建應用程序。

✨ 主要特性

• 提供獲取特定美國州份天氣警報的工具，讓你及時掌握當地天氣動態。
• 支持使用座標獲取任何地理位置的詳細天氣預報，無論你身處何方，都能精準瞭解天氣情況。
• 涵蓋溫度、風力條件和簡要天氣描述等信息，滿足你對天氣信息的基本需求。
• 數據來自國家氣象局，確保信息的即時性和準確性。

📦 安裝指南

先決條件

• Node.js（v16 或更高版本）
• npm 或 yarn 包管理器

安裝步驟

1. 克隆倉庫：

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

2. 安裝依賴項：

npm install

3. 構建應用程序：

npm run build

💻 使用示例

MCP 工具

該服務器提供兩個 MCP 工具，供 AI 代理使用：

get-alerts

獲取特定美國州份的天氣警報。

參數：

• state：兩位字母的狀態代碼（例如 CA、NY）

示例響應：

{
  "content": [
    {
      "type": "text",
      "text": "CA 狀態的活躍警報：..."
    }
  ]
}

get-forecast

使用座標獲取特定位置的天氣預報。

參數：

• latitude：位置的緯度（-90 到 90）
• longitude：位置的經度（-180 到 180）

示例響應：

{
  "content": [
    {
      "type": "text",
      "text": "早晨：溫度：72°F，風速：5mph NW，多雲..."
    }
  ]
}

📚 詳細文檔

項目結構

weather/
├── src/
│   └── index.ts    # 主服務器代碼，包含MCP工具實現
├── build/          # 編譯後的 JavaScript 文件
├── package.json    # 項目依賴和腳本
└── tsconfig.json   # TypeScript 配置

開發

要修改或擴展服務器：

1. 在 src/index.ts 文件中進行更改。
2. 重建應用程序：

npm run build

依賴項

• @modelcontextprotocol/sdk：MCP 服務器實現框架。
• zod：工具參數的運行時類型檢查和驗證。
• TypeScript：用於類型安全的開發依賴。

🔧 技術細節

• 使用 TypeScript 開發，保證代碼的類型安全和可維護性。
• 實現模型上下文協議（MCP）服務器，為 AI 代理提供服務。
• 使用 @modelcontextprotocol/sdk 進行 MCP 服務器實現，提高開發效率。
• 與國家氣象局（NWS）API 接口交互，獲取即時天氣數據。
• 目標為 ES2022，使用 Node16 模塊解析，確保項目的兼容性和性能。

📄 許可證

本項目採用 ISC 許可證。

注意事項

⚠️ 重要提示

• 該服務器僅適用於美國地區，因為它使用國家氣象局 API。
• API 請求受到速率限制，並且需要 User-Agent 標頭。
• 所有座標應為十進制度數格式。
• 這不是一個獨立的 CLI 應用程序，而是一個通過模型上下文協議為 AI 代理提供工具的服務器。