Roc Cwa MCP

🚀 Taiwan Central Weather Bureau MCP Server

This project offers a Model Context Protocol (MCP) server that connects to the Taiwan Central Weather Bureau (CWA) API, enabling you to easily access weather data in Taiwan.

English Version

🚀 Quick Start

This project provides a Model Context Protocol (MCP) server that connects to the Taiwan Central Weather Bureau (CWA) API, allowing you to effortlessly obtain weather data in Taiwan.

✨ Features

• Retrieve 3-day weather forecast data for each county and city in Taiwan.
• Retrieve 1-week weather forecast data for each county and city in Taiwan.
• Retrieve historical rainfall data for the past 3 days.
• Automatically perform data cleaning and format conversion.
• Simplify API output to include only essential information.

📦 Installation

System Requirements

• Python 3.10+
• MCP CLI 1.6.0+
• uv package manager

Steps

1. Ensure that Python 3.10 or a later version is installed.
2. Install dependencies using uv:

# Install project dependencies using uv
uv pip install -e .

💻 Usage Examples

Start the Server

For Windows Users

# Execute in Command Prompt or PowerShell
uv --directory your_project_path run src/server.py your_API_key

For Mac and Linux Users

# Execute in the terminal
uv --directory your_project_path run src/server.py your_API_key

Available MCP Tools

This server provides the following three main tools:

1. get_3_days_weather

Retrieve the 3-day weather forecast data for a specified county or city.

Parameters:

• location_name (string): The name of the county or city, which must be a valid name of a county or city in Taiwan.

Valid county and city names include: Yilan County, Hualien County, Taitung County, Penghu County, Kinmen County, Lienchiang County, Taipei City, New Taipei City, Taoyuan City, Taichung City, Tainan City, Kaohsiung City, Keelung City, Hsinchu County, Hsinchu City, Miaoli County, Changhua County, Nantou County, Yunlin County, Chiayi County, Chiayi City, Pingtung County.

2. get_1_week_weather

Retrieve the 1-week weather forecast data for a specified county or city.

Parameters:

• location_name (string): The name of the county or city, which must be a valid name of a county or city in Taiwan.

3. get_rainfall_data

Retrieve historical rainfall data for the past 3 days.

No additional parameters are required.

📚 Documentation

CWA API Resources

To use this project, you need to obtain an API key from the Central Weather Bureau:

• CWA Open Data Platform: https://opendata.cwa.gov.tw/index
• API Documentation: https://opendata.cwa.gov.tw/dist/opendata-swagger.html
• API Key Application Guide: https://www.hlbh.hlc.edu.tw/resource/openfid.php?id=38959

API Data Sources

This project uses the following open data APIs provided by the Taiwan Central Weather Bureau:

• 3-day Forecast: Taiwan Township and City Weather Forecast - 3-day Weather Forecast (at 3-hour intervals)
• 1-week Forecast: Taiwan Township and City Weather Forecast - 1-week Weather Forecast
• Rainfall Data: Automatic Meteorological Stations - Rainfall Observation Data