MCP Weather Server Tke

🚀 MCP 天氣服務器

本項目是一個用 TypeScript 實現的 Model Context Protocol (MCP) 服務器，藉助 Server-Sent Events (SSE) 協議為用戶提供便捷的天氣信息查詢工具。它突破了傳統本地通信的侷限，通過 HTTP 實現遠程連接，讓客戶端能通過網絡輕鬆獲取天氣數據。

🚀 快速開始

MCP 天氣服務器實現了模型上下文協議，藉助 SSE 運輸協議，為用戶提供天氣預報與預警工具。與常見的使用本地通信的 stdio 標準示例不同，此服務器通過 HTTP 實現遠程連接，允許客戶端通過網絡進行連接。

啟動服務器：

node build/index.js

這將默認在端口 3001 上運行服務器。您應該會看到類似以下的輸出：

天氣 MCP 服務器正在 http://localhost:3001 運行
請客戶端連接到 http://localhost:3001/sse

測試服務器

可以通過以下命令測試服務器是否正常運行：

curl http://localhost:3001/sse

這將返回一個帶有會話 ID 的事件。

✨ 主要特性

• 基於 SSE 運輸協議實現 MCP。
• 提供兩個實用的天氣工具：
  • get-forecast：可獲取特定座標點的天氣預報。
  • get-alerts：能獲取美國各州的活躍天氣預警。
• 連接到美國國家氣象局（NWS）API，數據權威可靠。
• 支持多個客戶端同時連接，滿足多人使用需求。

📦 安裝指南

# 克隆倉庫
git clone https://github.com/tyfeng1997/mcp-server.git
cd mcp-server

# 安裝依賴項
npm install

# 編譯 TypeScript 代碼
npm run build

💻 使用示例

可用工具

該服務器提供了兩個工具：

1. get-forecast

• 描述：獲取某個位置的天氣預報。
• 參數：
  • latitude（number）：位置的緯度 (-90 到 90)。
  • longitude（number）：位置的經度 (-180 到 180)。
• 注意：僅支持美國地區的 NWS API。

2. get-alerts

• 描述：獲取某個州的天氣預警。
• 參數：
  • state（string）：兩位字母的美國州代碼（例如 CA、NY）。

📚 詳細文檔

伴侶客戶端

該服務器設計用於與 MCP 客戶端配合使用，可在 tyfeng1997/mcp-client 找到。客戶端連接到此服務器，並允許像 Claude 這樣的 AI 助手通過自然語言使用天氣工具。

自定義配置

端口配置

要更改端口，請在代碼中修改 PORT 常量：

const PORT = 3001; // 更改為您所需的端口

添加更多工具

可以通過以下模式添加更多工具：

server.tool(
  "your-tool-name",
  "您的工具描述",
  {
    // 參數 schema 使用 zod
    param1: z.string().describe("參數描述"),
    param2: z.number().describe("參數描述"),
  },
  async ({ param1, param2 }) => {
    // 工具實現
    return {
      content: [
        {
          type: "text",
          text: "工具結果",
        },
      ],
    };
  }
);

貢獻指南

歡迎貢獻！請隨意提交 Pull Request。

📄 許可證

該項目使用 MIT 許可證，詳細信息請參閱 LICENSE 文件。