MCP Server Taiwan Weather

🚀 臺灣氣象 - 中央氣象局 MCP Server (非官方)

這是一個用於獲取臺灣中央氣象局 API 數據的 Model Context Protocol (MCP) Server。它能幫助你輕鬆獲取臺灣各地區的天氣預報信息，為你的應用提供準確的氣象數據支持。

🚀 快速開始

臺灣中央氣象局 API 授權碼

你需要先獲取臺灣中央氣象局 API 授權碼：

• 訪問 https://opendata.cwa.gov.tw/user/authkey（需登錄賬號，沒有的話請註冊）
• 點擊 “取得授權碼” 按鈕
• 複製授權碼

用於 Claude Desktop 或其他支持 MCP 的應用程序

若要在 Claude Desktop 中使用，請將以下內容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "taiwan-weather": {
      "command": "npx",
      "args": [
        "-y",
        "@gonetone/mcp-server-taiwan-weather"
      ],
      "env": {
        "CWA_API_KEY": "<您的中央氣象局 API 授權碼>"
      }
    }
  }
}

如果要在其他支持 MCP 的應用程序中使用，請參考該應用程序的配置文件。

✨ 主要特性

• 獲取臺灣各市縣天氣預報數據 - 今明 36 小時天氣預報

📦 安裝指南

Windows npx 問題

如果在 Windows 上使用 npx 執行 MCP Server 時無法執行，可以嘗試以下方法：

使用 cmd 執行 npx

配置改用 cmd 執行 npx：

{
  "mcpServers": {
    "taiwan-weather": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@gonetone/mcp-server-taiwan-weather"
      ],
      "env": {
        "CWA_API_KEY": "<您的中央氣象局 API 授權碼>"
      }
    }
  }
}

改用 node 執行

將 @gonetone/mcp-server-taiwan-weather 全局安裝：

npm install -g @gonetone/mcp-server-taiwan-weather

然後配置改用 node 執行：

{
  "mcpServers": {
    "taiwan-weather": {
      "command": "node",
      "args": [
        "<your-path>/node_modules/@gonetone/mcp-server-taiwan-weather"
      ],
      "env": {
        "CWA_API_KEY": "<您的中央氣象局 API 授權碼>"
      }
    }
  }
}

你可以使用 npm root -g 命令來查看全局安裝的 node_modules 目錄路徑。

💻 使用示例

基礎用法

以下是一些對話例子，展示如何獲取臺灣各市縣天氣預報數據 - 今明 36 小時天氣預報：

• 高雄今天天氣如何呢？
• 我想知道屏東的天氣
• 臺北氣象預報

📚 詳細文檔

API

Tools

1. get_taiwan_weather_forecast
   • 獲取臺灣各市縣天氣預報數據 - 今明 36 小時天氣預報
   • 輸入參數：
     • locationName (string): 臺灣市縣名稱
   • 返回值：中央氣象局 API F-C0032-001 數據 Json (key records)

🔧 技術細節

Model Context Protocol (MCP) 是什麼？

MCP 是一個開放協議，它標準化了應用程序如何為大型語言模型 (LLMs) 提供上下文。可以將 MCP 想象成 AI 應用程序的 USB - C 接口。就像 USB - C 為你的設備提供了一種標準化的方式來連接各種外圍設備和配件，MCP 提供了一種標準化的方式來將 AI 模型連接到不同的數據源和工具。 詳細介紹請參考 Model Context Protocol 官方頁面。

📄 許可證

本 MCP 服務器採用 MIT 許可證。這意味著你可以自由使用、修改和分發該軟件，但需遵守 MIT 許可證的條款和條件。更多詳情，請查看項目倉庫中的 LICENSE 文件。

🔧 測試

可以使用 MCP Inspector 來測試 MCP Server：

npx -y @modelcontextprotocol/inspector -e CWA_API_KEY={您的中央氣象局 API 授權碼} node .

詳情請參考 MCP Inspector 官方頁面。

🤝 貢獻

你可以在 GitHub 上的 https://github.com/GoneTone/mcp-server-taiwan-weather 提出 Issues 和 Pull requests。

構建

yarn build