🚀 台湾中央气象局 MCP 服务器

本项目搭建了一个模型上下文协议（MCP）服务器，该服务器与台湾中央气象局（CWA）的 API 接口相连接，能让您轻松获取台湾地区的天气数据。

English Version

🚀 快速开始

要使用此项目，您需先从中央气象局获取一个 API 密钥：

• CWA 开放资料平台：https://opendata.cwa.gov.tw/index
• API 文档：https://opendata.cwa.gov.tw/dist/opendata-swagger.html
• API 密钥申请指南：https://www.hlbh.hlc.edu.tw/resource/openfid.php?id=38959

✨ 主要特性

• 获取台湾各县市未来 3 天的天气预报数据
• 获取台湾各县市未来 1 周的天气预报数据
• 获取过去 3 天的历史降雨数据
• 自动进行数据清理和格式转换
• 简化的 API 输出，仅包含必需信息

📦 安装指南

系统要求

• Python 3.10+
• MCP CLI 1.6.0+
• uv 包管理器

安装步骤

1. 确保安装了 Python 3.10 或更高版本。
2. 使用 uv 安装依赖项：

# 使用uv安装项目依赖项
uv pip install -e .

💻 使用示例

启动服务器

Windows 用户

# 在命令提示符或PowerShell中执行
uv --directory 您的项目路径 run src/server.py 您的API密钥

Mac 和 Linux 用户

# 在终端中执行
uv --directory 您的项目路径 run src/server.py 您的API密钥

可用 MCP 工具

此服务器提供以下三个主要工具：

基础用法

get_3_days_weather

获取指定县市未来 3 天的天气预报数据。

# 参数：
# - `location_name` (字符串)：县市名称，必须是有效的台湾县市名称
# 有效县市名称包括：宜兰县、花莲县、台东县、澎湖县、金门县、连江县、台北市、新北市、桃园市、台中市、台南市、高雄市、基隆市、新竹县、新竹市、苗栗县、彰化县、南投县、云林县、嘉义县、嘉义市、屏东县

get_1_week_weather

获取指定县市未来 1 周的天气预报数据。

# 参数：
# - `location_name` (字符串)：县市名称，必须是有效的台湾县市名称

高级用法

get_rainfall_data

获取过去 3 天的历史降雨数据。

# 无额外参数需要提供。

📚 详细文档

API 数据来源

此项目使用了台湾中央气象局提供的以下开放数据 API：

• 未来 3 天预报：台湾乡鎮市天气预报 - 3 日天气预测（每 3 小时间隔）
• 未来 1 周预报：台湾乡鎮市天气预报 - 1 週天氣預報
• 降雨数据：自動 Meteorological 站 - 降雨观测资料