Taiwan Central Weather Administration MCP Server

产品定位

roc-cwa-mcp 是一个与台湾中央气象局（CWA）API 接口的 Model Context Protocol (MCP) 服务器，提供台湾地区的天气数据访问服务。

核心功能

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

适用场景

• 需要获取台湾地区天气数据的应用
• 需要历史降雨数据的分析
• 需要简化天气数据格式的开发项目

工具列表

1. get_3_days_weather：获取指定县市的3天天气预报数据。

2. 参数：location_name（字符串），必须为有效的台湾县市名称。

3. get_1_week_weather：获取指定县市的1周天气预报数据。

4. 参数：location_name（字符串），必须为有效的台湾县市名称。

5. get_historical_rainfall：获取过去三天的降雨数据。

6. 无需参数。

常见问题解答

• 如何获取API密钥？ 需要从台湾中央气象局开放数据平台申请API密钥。

• 支持的县市有哪些？ 包括宜兰县、花莲县、台东县、澎湖县、金门县、连江县、台北市、新北市、桃园市、台中市、台南市、高雄市、基隆市、新竹县、新竹市、苗栗县、彰化县、南投县、云林县、嘉义县、嘉义市、屏东县等。

使用教程

使用依赖

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

安装教程

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

uv pip install -e .

启动服务器

Windows 用户

uv --directory your_project_path run src/server.py your_API_key

Mac 和 Linux 用户

uv --directory your_project_path run src/server.py your_API_key

调试方式

启动服务器后，可以使用提供的工具进行数据获取测试。例如：

# 获取台北市的3天天气预报
get_3_days_weather --location_name "台北市"

# 获取高雄市的1周天气预报
get_1_week_weather --location_name "高雄市"

# 获取历史降雨数据
get_historical_rainfall

许可证

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