cwa-mcp-server
MCP server,包中央氣象署(CWA)開放資料 API,讓 agent 能查天氣預報、地震報告、天氣特報、颱風警報,並產生避難建議。
功能
- Tool
get_weather_forecast(county)— 縣市未來 36 小時天氣預報 - Tool
get_earthquake_report(limit)— 最近 N 筆顯著有感地震報告 - Tool
get_weather_warning(county)— 縣市目前生效中的天氣特報(豪雨、強風等) - Tool
get_typhoon_warning(limit)— 最近 N 筆颱風警報 - Resource
cwa://counties— 合法縣市名稱清單 - Prompt
evacuation_advisory(county)— 根據即時天氣/特報/地震/颱風資料生成避難建議的提示模板
申請 API Key
- 到 氣象資料開放平台 註冊會員(email + 密碼即可,免審核)
- 登入後點「API 授權碼」→「取得授權碼」,立即產生 key
安裝(一般使用者)
已發布到 PyPI,不需要 clone 這個 repo。在 Claude Desktop / Claude Code 的 MCP 設定裡指定 uvx 執行即可,會自動抓套件:
{
"mcpServers": {
"cwa-weather": {
"command": "uvx",
"args": ["cwa-mcp-server"],
"env": { "CWA_API_KEY": "你申請到的授權碼" }
}
}
}
或用 Claude Code CLI:
claude mcp add cwa-weather -e CWA_API_KEY=你申請到的授權碼 -- uvx cwa-mcp-server
開發(改這個 repo 原始碼)
git clone https://github.com/gary2376/cwa-mcp-server
cd cwa-mcp-server
uv sync
cp .env.example .env # 填入 CWA_API_KEY
uv run python tests/test_client.py # 最小自我檢查(不打真網路)
uv run mcp dev src/cwa_mcp/server.py # 本地用 inspector 手動測試 tools
狀態
四個 tool(天氣預報、地震報告、天氣特報、颱風警報)都已用真實 key 打過線上 API 驗證,也已接上 Claude Code 實測對話流程,能正確判斷風險等級並給出具體建議。已發布到 PyPI 與 MCP Server Registry。
已知修過的坑:v0.1.0 最初上傳的 wheel 因為 uv_build 預設用 project.name 猜模組名(cwa_mcp_server),跟實際原始碼目錄 src/cwa_mcp/ 對不上,打包出一個空殼套件,uvx cwa-mcp-server 會直接 ModuleNotFoundError。已在 pyproject.toml 加 [tool.uv.build-backend] module-name = "cwa_mcp" 修正,重新 build 驗證過 wheel 內容正確。
License
MIT
Metadata
Release files for cwa-mcp-server 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cwa_mcp_server-0.1.1.tar.gz | 4.7 kB | Without provenance | Details for cwa_mcp_server-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cwa_mcp_server-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for cwa_mcp_server-0.1.1-py3-none-any.whl |
Total release size: 11.6 kB
Release files / cwa_mcp_server-0.1.1.tar.gz
| Download URL | cwa_mcp_server-0.1.1.tar.gz |
|---|---|
| Size | 4.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e04f778ff2d9ce5720f510b67f3586efc671f381449ca9d90a0245280dd9f570
|
|
BLAKE2b-256 checksum How to use checksums |
c91035c60809bb997275dcba618dcd6cae4cca96fd056df9064aad69d6b3cb92
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / cwa_mcp_server-0.1.1-py3-none-any.whl
| Download URL | cwa_mcp_server-0.1.1-py3-none-any.whl |
|---|---|
| Size | 6.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b8b518fb8911a395428c768c440315c269d8586d280e189818f63c50ca4754ad
|
|
BLAKE2b-256 checksum How to use checksums |
53d8f7ad6d505935c027ffc1b8fd7e8d70ffbb430b9ea5638be2c05b039c1c0e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for cwa-mcp-server 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.