Metadata-Version: 2.4
Name: tw-cwa-weather-mcp
Version: 1.0.0
Summary: Taiwan CWA Weather MCP Server - Access Taiwan weather data through Model Context Protocol
Author-email: nigue3025 <your-email@example.com>
License: MIT
Project-URL: Homepage, https://github.com/nigue3025/tw_cwa_weather_mcp
Project-URL: Repository, https://github.com/nigue3025/tw_cwa_weather_mcp
Project-URL: Issues, https://github.com/nigue3025/tw_cwa_weather_mcp/issues
Keywords: mcp,model-context-protocol,taiwan,weather,cwa
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: requests>=2.32.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: httpx>=0.28.0
Dynamic: license-file

# Taiwan CWA Weather MCP Server

Access Taiwan Central Weather Administration (CWA) weather data and forecasts through the Model Context Protocol.

<!-- mcp-name: io.github.nigue3025/tw-cwa-weather-mcp -->

## Features

- Get weather forecasts for all Taiwan counties and cities
- List available locations
- Support for location aliases
- Real-time data from Taiwan CWA OpenData API

## Tools

### get_weather
Get weather forecast data for a specific Taiwan location.

**Parameters:**
- `given_location` (string): The county or city name (supports both Chinese and aliases)

**Returns:** Weather forecast data including temperature, rainfall probability, weather conditions, and comfort level.

### list_available_locations
List all available Taiwan counties/cities and their aliases.

**Returns:** Complete list of supported locations and their alternative names.

## Installation

```bash
pip install tw-cwa-weather-mcp
```

## Configuration

You need a Taiwan CWA API key to use this server. Create a file named `GOV_api_key.txt` in the server directory with your API key.

Get your API key from: https://opendata.cwa.gov.tw/

## Usage

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "taiwan-weather": {
      "command": "python",
      "args": ["-m", "tw_cwa_weather_mcp"]
    }
  }
}
```

## Development

This server uses FastMCP to provide Taiwan weather data through the Model Context Protocol.

## License

MIT License

## Author

nigue3025
