cwa-mcp-server

MCP サーバー。中央気象署（CWA）のオープンデータ API をラップし、エージェントが天気予報、地震報告、気象特報、台風警報を照会して、避難アドバイスを生成できるようにします。

機能

Related MCP server: mcp-cwa

ツール get_weather_forecast(county) — 指定した県・市の今後 36 時間の天気予報

ツール get_earthquake_report(limit) — 直近 N 件の顕著な有感地震報告

ツール get_weather_warning(county) — 指定した県・市で現在有効な気象警報（大雨、強風など）

ツール get_typhoon_warning(limit) — 直近 N 件の台風警報

リソース cwa://counties — 有効な県市名の一覧

プロンプト evacuation_advisory(county) — リアルタイムの天気・警報・地震・台風データに基づいて避難アドバイスを生成するためのプロンプトテンプレート

API Key の申請

1. 気象データ開放プラットフォーム で登録（メールとパスワードのみ、審査不要）

2. ログイン後、「API 認可コード」→「認可コードを取得」をクリックすると、即座にキーが生成されます

インストール（一般ユーザー）

PyPI に公開済みなので、この 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

状態

4つのツール（天気予報、地震報告、気象警報、台風警報）はすべて実キーでオンライン 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" を追加して修正し、ビルドし直して内容が正しいことを検証済みです。

License

MIT