台灣中央氣象局 MCP 伺服器

台灣中央氣象局 MCP 伺服器

site icon
2025.04.14 0
TypeScript天气服务气象数据位置服务
台湾中央气象局 MCP 服务器是一个与台湾中央气象局 (CWA) API 进行对接的 Model Context Protocol (MCP) 服务器,主要用于获取台湾地区的天气数据。该服务器提供了未来3天和1周的天气预报数据,以及过去三天的雨量数据,并具备自动数据清理、格式转换、错误处理机制和重试逻辑等功能。
View on GitHub

Overview

基本能力

产品定位

该 MCP 服务器主要用于获取和处理台湾地区的天气数据,为开发者提供简化的 API 接口,方便集成到各种应用中。

核心功能

  • 获取台湾各市县未来3天的天气预报数据
  • 获取台湾各市县未来1周的天气预报数据
  • 获取过去三天的雨量数据
  • 自动数据清理与格式转换
  • 错误处理机制与重试逻辑
  • 简化的 API 输出,仅包含必要信息

适用场景

  • 天气应用开发
  • 气象数据分析
  • 灾害预警系统
  • 旅行规划应用

工具列表

  1. get_3_days_weather: 获取指定市县未来3天的天气预报数据。参数包括有效的台湾市县名称。
  2. get_1_week_weather: 获取指定市县未来1周的天气预报数据。参数包括有效的台湾市县名称。
  3. get_historical_rainfall: 获取过去三天的雨量数据。

常见问题解答

  • 需要从中央气象局获取 API 密钥才能使用该服务。
  • 支持的环境变量配置包括 API 密钥、最大重试次数和超时设置。

使用教程

使用依赖

  1. 安装 Claude Desktop,确保使用最新版本。
  2. 从中央气象局获取 API 密钥。

安装教程

  1. Claude Desktop 设置 json { "mcpServers": { "taiwan-weather": { "command": "npx", "args": [ "taiwan-cwa-mcp-server" ], "env": { "CWA_API_KEY": "您的API金鑰" } } } }
  2. 本地开发版本启动 json { "mcpServers": { "taiwan-weather": { "command": "npx", "args": [ "tsx", "/您的專案目錄路徑/src/server.ts" ], "env": { "CWA_API_KEY": "您的API金鑰", "MAX_RETRIES": "3", "TIMEOUT_MS": "10000" } } } }

调试方式

  1. 使用 fastmcp dev 测试 bash npm run dev # 或 npx fastmcp dev src/server.ts
  2. 使用 MCP Inspector 检查 bash npm run inspect # 或 npx fastmcp inspect src/server.ts

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。