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