cwa-mcp-server

MCP-Server, der die offenen Daten-API der Central Weather Administration (CWA) umfasst, sodass Agenten Wettervorhersagen, Erdbebenberichte, Wetterwarnungen, Taifunwarnungen abfragen und Evakuierungsempfehlungen generieren können.

Funktionen

• Tool get_weather_forecast(county) — Wettervorhersage für die nächsten 36 Stunden für einen Landkreis

• Tool get_earthquake_report(limit) — Die letzten N spürbaren Erdbebenberichte

• Tool get_weather_warning(county) — Derzeit aktive Wetterwarnungen (Starkregen, starke Winde usw.) für einen Landkreis

• Tool get_typhoon_warning(limit) — Die letzten N Taifunwarnungen

• Resource cwa://counties — Liste der gültigen Landkreisnamen

• Prompt evacuation_advisory(county) — Eine Prompt-Vorlage zur Generierung von Evakuierungsempfehlungen basierend auf Echtzeit-Wetter/Warnungen/Erdbeben/Taifun-Daten

Related MCP server: mcp-cwa

API-Key beantragen

1. Registrieren Sie sich auf der Wetterdaten-Open-Plattform (E-Mail + Passwort reichen aus, keine Genehmigung erforderlich)

2. Klicken Sie nach der Anmeldung auf „API-Autorisierungscode“ → „Autorisierungscode abrufen“, der Schlüssel wird sofort generiert

Installation (für allgemeine Benutzer)

Wurde auf PyPI veröffentlicht, ein Klonen dieses Repos ist nicht erforderlich. Geben Sie in der MCP-Konfiguration von Claude Desktop / Claude Code die Ausführung mit uvx an, das Paket wird automatisch abgerufen:

{
  "mcpServers": {
    "cwa-weather": {
      "command": "uvx",
      "args": ["cwa-mcp-server"],
      "env": { "CWA_API_KEY": "你申請到的授權碼" }
    }
  }
}

Oder mit der Claude Code CLI:

claude mcp add cwa-weather -e CWA_API_KEY=你申請到的授權碼 -- uvx cwa-mcp-server

Entwicklung (Ändern des Quellcodes dieses Repos)

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

Status

Alle vier Tools (Wettervorhersage, Erdbebenbericht, Wetterwarnung, Taifunwarnung) wurden mit echten Schlüsseln gegen die Online-API validiert und auch mit Claude Code in einem realen Dialogablauf getestet, der Risikostufen korrekt einschätzt und konkrete Empfehlungen gibt. Wurde auf PyPI und im MCP Server Registry veröffentlicht.

Bekannte behobene Probleme: Das ursprünglich in v0.1.0 hochgeladene Wheel hatte ein Problem, da uv_build standardmäßig project.name verwendet, um den Modulnamen zu erraten (cwa_mcp_server), was nicht mit dem tatsächlichen Quellcode-Verzeichnis src/cwa_mcp/ übereinstimmte, was zu einem leeren Paket führte. uvx cwa-mcp-server führte direkt zu einem ModuleNotFoundError. Dies wurde durch Hinzufügen von [tool.uv.build-backend] module-name = "cwa_mcp" in pyproject.toml behoben, und das Wheel wurde nach dem Neubuild auf korrekten Inhalt überprüft.

Lizenz

MIT