台湾气象局 - 中央气象局 MCP 服务器（非官方）

用于获取台湾中央气象局 API 的数字模型上下文协议（MCP）服务器。

模型上下文协议（MCP）是什么？

MCP 是一个开放协议，标准化了应用程序如何为大型语言模型（LLMs）提供上下文。可以将其想象为AI应用的USB-C接口。就像USB-C提供了一种标准方式让你的设备连接各种外设和配件一样，MCP提供了一种标准方式让模型连接到不同的数据源和工具。

对于详细介绍，请参阅 模型上下文协议 官方页面。

功能

• 获取台湾各县市的天气预报数据 - 今天和明天的36小时天气预报

API

工具

1. get_taiwan_weather_forecast
   • 获取台湾各县市的天气预报数据 - 今天和明天的36小时天气预报
   • 输入参数：
     • locationName (字符串)：台湾县市名称
   • 返回值：中央气象局 API F-C0032-001 数据 JSON（关键记录）

对话示例

获取台湾各县市的天气预报数据 - 今天和明天的36小时天气预报

• 高雄今天的天气怎么样？
• 我想知道屏东的天气
• 台北天气预报

设置

台湾中央气象局 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 的应用程序中使用，请参考该应用程序的设置文件。

Windows 上 npx 的问题

如果在 Windows 上使用顶部的 npx 执行 MCP 服务器无法执行，您可以尝试以下方法之一：

使用 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 目录路径。

贡献

问题和拉取请求可以在 GitHub 上的 https://github.com/GoneTone/mcp-server-taiwan-weather 提出。

构建

yarn build

测试

可以使用 MCP Inspector 来测试 MCP 服务器：

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

详情请参阅 MCP Inspector 官方页面。

许可证

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由地使用、修改和分发软件，但需遵守 MIT 许可证中的条款和条件。更多详情请参见项目仓库中的 LICENSE 文件。