Back to Directory/Developer Tools

io.github.GoneTone/mcp-server-taiwan-weather

用於取得臺灣中央氣象署 API 資料的 Model Context Protocol (MCP) Server

Developer ToolsTypeScriptv0.1.4

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

用於取得臺灣中央氣象署 API 資料的 Model Context Protocol (MCP) Server。

Model Context Protocol (MCP) 是什麼?

MCP 是一個開放協議,它標準化了應用程式如何為大型語言模型 (LLMs) 提供上下文。可以將 MCP 想像成 AI 應用程式的 USB-C 接口。就像 USB-C 為您的設備提供了一種標準化的方式來連接各種外圍設備和配件,MCP 提供了一種標準化的方式來將 AI 模型連接到不同的數據源和工具。

詳細介紹請參考 Model Context Protocol 官方頁面。

功能

  • 取得臺灣各縣市天氣預報資料 - 今明 36 小時天氣預報

API

Tools

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

對話例子

取得臺灣各縣市天氣預報資料 - 今明 36 小時天氣預報

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

設置

臺灣中央氣象署 API 授權碼

您必須先取得臺灣中央氣象署 API 授權碼:

用於 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 的應用程式中使用,請參考該應用程式的設定文件。

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 目錄路徑。

貢獻

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

Build

yarn build

Test

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

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

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

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @gonetone/mcp-server-taiwan-weather

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-gonetone-mcp-server-taiwan-weather": {
      "command": "npx",
      "args": [
        "-y",
        "@gonetone/mcp-server-taiwan-weather"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@gonetone/mcp-server-taiwan-weathernpm

Compatible MCP Clients

io.github.GoneTone/mcp-server-taiwan-weather works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More