🚀 台湾中央气象局 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 包管理器
安装步骤
- 确保安装了 Python 3.10 或更高版本。
- 使用 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 站 - 降雨观测资料