English Français العربية

io.github.gary2376/cwa-mcp-server

السجل الرسمي البيانات وقواعدها

MCP server for Taiwan CWA open data: weather forecast, earthquake, warnings, typhoon.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package cwa-mcp-server
Claude Code 
claude mcp add cwa-mcp-server -e 'CWA_API_KEY=<your cwa_api_key>' -- uvx cwa-mcp-server==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "cwa-mcp-server": {
            "command": "uvx",
            "args": [
                "cwa-mcp-server==0.1.1"
            ],
            "env": {
                "CWA_API_KEY": "<your cwa_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • CWA_API_KEY إلزامي سري CWA 開放資料平台 API 授權碼，至 https://opendata.cwa.gov.tw 免費申請

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. cwa-mcp-server
  2. 功能
  3. 申請 API Key
  4. 安裝（一般使用者）
  5. 開發（改這個 repo 原始碼）
  6. 狀態
  7. License

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

  1. 到 氣象資料開放平台 註冊會員（email + 密碼即可，免審核）
  2. 登入後點「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

الأسئلة الشائعة

ما هو io.github.gary2376/cwa-mcp-server؟

MCP server for Taiwan CWA open data: weather forecast, earthquake, warnings, typhoon.

كيف أثبّت io.github.gary2376/cwa-mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add cwa-mcp-server -e 'CWA_API_KEY=<your cwa_api_key>' -- uvx cwa-mcp-server==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.gary2376/cwa-mcp-server إلى مفتاح API؟

نعم. يتطلب CWA_API_KEY، وتضبطها في إعداداته.

هل io.github.gary2376/cwa-mcp-server مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.gary2376/cwa-mcp-server؟

ينشره gary2376. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.