opendata-mcp

台灣官方開放資料的統一 MCP（Model Context Protocol）閘道——一句話問天氣、地震、空品、交通，Claude 直接幫你查。

👉 看視覺化介紹頁面——比起先啃這份純文字 README，更快看懂這個專案在做什麼。

English README

這是什麼？

台灣各機關（中央氣象署、環境部、交通部……）各自開放了不少資料，但每個平台的申請流程、認證方式、欄位命名慣例都不一樣，一般使用者不會想為了問一句「臺北市明天會不會下雨」去查 API 文件。

opendata-mcp 是一個部署在 Cloudflare Workers 上的 Remote MCP Server，把這些分散的官方 API 收斂成一組好用的工具。接上 Claude 之後，你可以直接問：

• 「臺北市明天天氣如何？」

• 「最近台灣有地震嗎？規模多大？」

• 「新北市現在空氣品質好嗎？」

• 「國道三號現在有沒有事故？」

• 「板橋車站台鐵現在有沒有誤點？」

不用自己申請 API 金鑰、不用記資料集代碼、不用處理「臺」跟「台」哪個才對——Claude 會呼叫這個服務即時查詢，並把官方回應整理成好讀的答案。

目前規模：9 個精選工具（涵蓋天氣、地震、颱風、空品、公車、YouBike、台鐵、捷運、國道事件）+ 2 個通用查詢工具，串接 4 個資料平台（中央氣象署、環境部、交通部運輸資料流通服務 TDX、交通部高速公路局），共登記 19 筆資料集——其中 8 筆屬於長尾資料集，沒有專屬工具，但一樣可以透過通用工具查到。詳細清單見下方「支援的工具總覽」。

你可以直接用我們提供的公開 demo 服務，也可以照著下面「自行部署」章節架設一份完全屬於自己的服務（免費，只需要 Cloudflare 帳號）。

快速開始

不需要寫任何程式碼，幾分鐘內就能把這個服務加進你自己的 Claude：

1. 打開 claude.ai

2. 左下角 設定（Settings） → Connectors

3. 點選 Add custom connector

4. 貼上以下網址：

   https://opendata-mcp.dragonheartliu1440.workers.dev/mcp

5. 儲存後回到對話視窗，直接問「臺北市明天天氣如何？」試試看

⚠️ 這是一個公開展示（demo）服務，僅供測試使用，沒有登入機制、沒有專屬額度保證。流量較大時可能回應較慢或暫時不穩定，也可能因為共用的官方 API 額度被其他使用者用完而暫時查不到資料。若要長期、穩定地使用（尤其是要接 TDX 公車/YouBike/台鐵/捷運這幾個工具），強烈建議參考下面「自行部署」章節，架設一份屬於自己的服務——完全免費，用的是你自己申請的 API 金鑰與 Cloudflare 帳號額度。

這個 demo 服務有做 per-IP 流量限制（每分鐘每個 IP 60 次請求），用來保護共用的官方 API 額度不被單一來源打爆；一般對話使用不會碰到這個門檻，超過時會收到明確的錯誤訊息（含建議等待時間），不會讓連線莫名斷掉。

接進其他 AI 平台

本服務基於標準 MCP 協議建置，不限於 Claude 使用，支援任何 MCP 相容的 AI 平台，包括 ChatGPT、Cursor、Windsurf、Cline 等。

ChatGPT

Settings → Apps & Connectors → Advanced settings → 開啟 Developer Mode → 新增自訂連接器，填入伺服器網址（同上），驗證方式選擇「無」（本服務不需要任何驗證）。

⚠️ 已知差異：ChatGPT 不會像 Claude 一樣主動判斷該不該呼叫外部工具，建議提問時明確提及要使用這個連接器，例如「請使用 OpenData MCP 查詢臺北市天氣」，而不是單純自然地問「臺北市天氣如何」——否則 ChatGPT 可能會用自己內建的知識或網路搜尋回答，不會主動想到查詢即時資料。

Cursor / Windsurf / Cline

在 MCP servers 設定（通常是一個 JSON 設定檔）裡新增：

{
  "opendata-mcp": {
    "url": "https://opendata-mcp.dragonheartliu1440.workers.dev/mcp"
  }
}

不需要額外的認證設定。

支援的工具總覽

精選工具（9 個，直接可用）

💡 每個工具的完整參數說明、格式陷阱（例如「臺」不是「台」）、適用/不適用情境，Claude 呼叫工具前都看得到——工具本身的 description 就是最新的文件來源，這裡的表格只列摘要。

通用工具（2 個，涵蓋長尾資料集）

除了上面 9 個精選工具，本伺服器還登記了 8 筆長尾資料集（潮汐預報、氣象站觀測、天氣特報、紫外線指數每日最大值與即時值、颱風警報、空品預報、道路可變訊息標誌位置），這些資料集沒有專屬工具，但可以透過下面兩個通用工具查詢：

適用情境：想查的資料不在上面 9 個精選工具裡時，先用 tw_search_datasets 找找看，本伺服器可能已經登記了但還沒做成專屬工具。

自行部署

自行架設完全免費，大約 10-15 分鐘就能完成，不需要自己的伺服器。

前置需求：申請 API 金鑰

💡 都是免費申請。如果你只想先試用部分功能，可以只申請部分金鑰——沒設定金鑰的工具會回傳明確的錯誤訊息（附申請網址），不會讓整個服務掛掉，其他已設定金鑰的工具照常運作。

部署步驟

1. 把這個 repo Fork 到你自己的 GitHub 帳號

2. 登入 Cloudflare Dashboard → Workers & Pages → Create → Import an existing Git repository，選擇你剛剛 Fork 的 repo，其餘設定保持預設即可，直接部署

3. 部署完成後，到這個 Worker 的設定頁：Settings → Variables and Secrets，新增以下 Secrets（用 Secret，不要用一般環境變數，避免金鑰外洩）：

   Secret 名稱	值
   CWA_API_KEY	中央氣象署申請到的授權碼
   MOENV_API_KEY	環境部平臺取得的 API KEY
   TDX_CLIENT_ID	TDX 應用程式的 Client ID
   TDX_CLIENT_SECRET	TDX 應用程式的 Client Secret

4. 建立你自己的快取用 KV namespace（強烈建議，可加快回應速度、大幅減少對官方 API 的重複呼叫）：

   • 在你的 repo 目錄執行 npx wrangler kv namespace create CACHE，指令會回傳一組 namespace id

   • 打開 wrangler.toml，把 [[kv_namespaces]] 區塊裡的 id 換成你剛拿到的 id（不要沿用 repo 裡原本的 id，那是本專案 demo 部署自己的 namespace），commit 並 push

   • 不想用快取的話，直接刪掉整個 [[kv_namespaces]] 區塊也可以，服務一樣能運作，只是每次查詢都會直接呼叫官方 API，也享受不到 TDX OAuth token 快取的好處

5. 之後只要你 push 更新到 main 分支，Cloudflare 就會自動重新部署，不需要手動操作

把自己的服務接進 Claude

部署完成後，你會拿到一個類似這樣的網址：

https://<你的-worker-名稱>.<你的-account>.workers.dev/mcp

照著上面「快速開始」的步驟 1–5，把這個網址加進 Claude 的 Connectors 即可，之後就是使用你自己架設、用你自己 API 額度的服務。

架構說明

程式碼分四層，每層職責單一，新增一個資料集的成本壓到最低（一筆 registry entry + 一個 transform 函式 + 一組測試）：

tools/     MCP 對外介面。精選工具很薄：驗證輸入 → registry 查詢 → 快取 → 包信封回傳
registry/  每個資料集一筆 entry：參數 schema、URL 組裝規則、轉換函式、快取 TTL、關鍵字
adapters/  每個資料來源一個模組：認證注入、逾時重試、上游回應信封拆解、缺值正規化
infra/     HTTP client（timeout/retry）、KV 快取、統一回應信封、錯誤碼定義

完整的分層規劃、設計原則（忠實轉載、來源顯名、fail-loud vs fail-soft）與介面定義，見 docs/ARCHITECTURE.md；實際程式碼遵守的規範與已驗證過的上游行為陷阱，見 AGENTS.md。

品質保證

這個專案用三個 GitHub Actions workflow 做持續性的品質把關，設計成不依賴人工手動驗證，讓貢獻者可以放心送 PR：

三個 workflow 都能在 GitHub 網頁的 Actions 分頁手動觸發，不需要等排程或等下次部署。

資料來源與授權

本專案串接的資料，皆依政府資料開放授權條款第 1 版釋出：

• 天氣預報、地震報告、颱風消息：中央氣象署開放資料平臺

• 空氣品質指標（AQI）：環境部環境資料開放平臺

• 公車動態、YouBike、台鐵到離站看板、捷運營運狀態：交通部運輸資料流通服務（TDX）

• 國道即時交通事件：交通部高速公路局『交通資料庫』

免責聲明：本專案僅為官方開放資料的轉載與整理工具，不自行生成、推測或判斷任何預報、警報或路況內容，也不保證資料的即時性與準確性（查詢結果依各資料集更新頻率有短時間快取，最多可能有數分鐘延遲）。防災、颱風、地震、空品惡化、道路封閉等相關警特報訊息，請務必以中央氣象署、環境部、交通部及所屬機關官方網站、官方 App 或其他官方管道公布之內容為準；本專案不提供任何形式的氣象預報、警特報發布或交通指揮服務，亦不承擔因使用本專案資料所產生之任何損失或責任。

隱私權政策（Privacy Policy）

最後更新：2026-07-27

這份政策說明公開 demo 服務（https://opendata-mcp.dragonheartliu1440.workers.dev）實際上會處理哪些資料。內容是依照這個 repo 的實際程式碼寫的，不是套用範本——每一項都可以在原始碼裡對照驗證。

我們不蒐集任何個人資料

本服務沒有登入機制、沒有帳號系統、沒有 cookie、沒有 session。伺服器本身是無狀態的（每個請求都建立全新的 MCP server 實例，處理完即銷毀，不保留任何跨請求狀態）。

我們不會收到、也無從得知你的姓名、email，或你在 Claude／ChatGPT 等平台上的帳號身分——MCP 協議本身不會傳送這些資訊，我們也沒有任何機制去索取。

唯一會收到的識別性資訊是 MCP initialize 請求裡的 clientInfo（用戶端軟體的名稱與版本，例如 claude-ai），這代表的是你用哪個 App 連線，不是你是誰。我們不儲存這個欄位。

因為完全沒有身分資訊，我們在技術上就不可能把某一筆查詢對應到某一個人。

查詢參數會被怎麼處理

你問的內容（例如縣市名稱「臺北市」、公車路線「615」、車站名稱「板橋」）會經過以下三個地方，以下據實說明：

1. 轉送給官方開放資料平台

這是本服務的核心功能：查詢參數會被組進 API 請求，送給對應的政府平台（中央氣象署／環境部／TDX／高速公路局）。這些平台看到的是本服務伺服器的 IP 與本服務的 API 金鑰，不是你的 IP——對它們而言所有查詢都來自同一個來源。它們如何處理這些請求，適用各該平台自己的隱私政策。

2. 暫存在 Cloudflare KV 快取（純資料快取，不含身分）

為了避免重複打官方 API（也為了遵守官方的擷取頻率規範），查詢結果會短時間快取。實際存的內容是：

• 快取的 key：資料集名稱 + 查詢參數，例如 weather:臺北市、aqi:county:新北市、bus-eta:Taipei:615:、rail:板橋:花蓮。

• 快取的 value：官方回傳並整理過的公開開放資料本身（天氣、AQI、到站時間等），不含任何請求方資訊。

關鍵在於：key 只記錄「被查了什麼」，完全不記錄「誰查的」——裡面沒有 IP、沒有使用者 id、沒有 session id，也沒有請求時間戳記。而且這份快取是全域共用的：所有使用者共用同一組 key，任何人查同一個縣市都會命中並覆寫同一筆資料，彼此無法區分。因此就算完整讀出整個快取，能得知的也只是「最近有人查過臺北市」，無法得知是誰、有幾個人查過、或誰查了哪些不同的東西。

保存時間依資料集的更新頻率而定，由 KV 自動過期刪除，我們不做任何封存：

3. 錯誤診斷日誌（只在查詢失敗時，而且不含身分）

查詢成功時，你問了什麼完全不會被寫進任何日誌。

只有一種例外：當環境部（空氣品質資料的來源）的 API 出問題導致查詢失敗時，系統會記下一行訊息，好讓我們找出是哪裡壞掉。這行訊息裡會包含你查的那個縣市或測站名稱（例如「新北市」），以及環境部回傳的錯誤內容開頭（前 500 個字元）。金鑰已經遮蔽，而且一樣沒有任何指向你的資訊——沒有 IP、沒有使用者識別。

白話說：如果你查空品時剛好碰上環境部故障，被記下來的是「有人查了新北市」，而不是「你查了新北市」。這行紀錄由 Cloudflare 依其預設期限自動刪除，我們不另外匯出或備份。

來源 IP 與流量限制

本服務對 /mcp 做 per-IP 流量限制（每分鐘每 IP 60 次），實作方式是把 Cloudflare 邊緣提供的來源 IP（cf-connecting-ip）當作 Cloudflare 原生 Rate Limiting 服務的計數器 key。

明確說明這件事：我們不會把這個 IP 寫進 KV、不會寫進日誌、也不會把它跟你查詢的內容關聯起來。它只作為 Cloudflare 內部計數器在 60 秒視窗內的識別鍵，視窗過後即失效，本服務的程式碼從頭到尾沒有任何一處儲存或記錄它。

另一方面，Cloudflare 作為本服務的託管商，本來就會處理你的請求（因此會看到來源 IP），並依 Cloudflare 自己的隱私政策保留其營運日誌。這是使用任何託管服務都無法避免的情況，我們無法代為排除，在此據實揭露。

是否與第三方分享資料

我們不販售、不出租、不為了廣告或分析目的與任何人分享資料。本服務沒有安裝任何分析工具（no Google Analytics、no 追蹤像素、no 廣告 SDK）。

基於服務運作所必要，資料會流經以下對象：

• 政府開放資料平台（中央氣象署／環境部／TDX／高速公路局）：接收查詢參數，如上所述。

• Cloudflare：託管平台，負責請求處理、KV 快取與流量限制。

此外，如果你用瀏覽器打開本專案的介紹頁面（只影響這個網頁，跟你在 Claude 裡呼叫工具完全無關）：這個頁面會向外部載入字體（Google Fonts）與 3D 背景用的程式庫（Three.js）。你的瀏覽器抓這些檔案時會直接連到對方的伺服器，因此這些服務會看到你的 IP 與瀏覽器版本資訊。只要網頁有載入外部字體或程式庫就會如此，不是本服務特有的行為。

白話說：Google 那邊只會知道「有人打開了這個網頁」，不會知道你在 Claude 裡問了什麼——介紹頁面是純靜態的網頁，跟查詢功能完全分開。如果你只透過 Claude 使用本服務、從來沒打開過介紹頁面，這一段完全不適用於你。

介紹頁面本身不設定任何 cookie、不會在你的瀏覽器留下任何本機儲存紀錄，也不會發出任何查詢請求（頁面上的示範內容是寫死的靜態範例，不是即時查詢）。實際會連到的網域：fonts.googleapis.com／fonts.gstatic.com（字體）、cdn.jsdelivr.net（Three.js，備援為 esm.sh／unpkg.com）。

自行部署

如果你依照「自行部署」章節架設自己的服務，你的查詢完全不會經過我們的部署——所有資料流向你自己的 Cloudflare 帳號與你自己申請的 API 金鑰，本政策所述的一切都與你無關。對隱私有較高要求時，這是最直接的做法。

聯絡方式

有任何隱私相關的問題、疑慮或更正要求，請透過 GitHub 聯繫：

• 開 issue：github.com/dragonheart8787/opendata-mcp/issues

• 專案首頁：github.com/dragonheart8787/opendata-mcp

政策異動

這份政策就存放在本 repo 的 README 裡，所有修改都會留在 git 歷史中，任何人都可以查閱完整的變更紀錄。

貢獻指南

歡迎 PR！這個專案刻意設計成新增一個資料集的成本很低——一筆 registry entry + 一個 transform 函式 + 一份 fixture + 一組測試就能完成，不需要碰到既有工具的程式碼。

在動手之前，請先讀：

1. AGENTS.md——分層架構的介面定義、工具描述五段式規範、測試要求、以及已經驗證過的上游行為陷阱（例如哪些機關的篩選參數不可信任、哪些資料集在雲端環境連不上）。這份文件是持續累積的工作規範，動工前先讀可以少走很多重複踩過的坑。

2. docs/ARCHITECTURE.md——完整架構規劃與設計原則。

送 PR 時請在描述裡列出：改動了哪些檔案（依分層歸類）、新增了哪些 registry entries、測試數量前後對比、以及任何與架構文件的偏離之處。有問題歡迎直接開 issue 討論。

License

程式碼採用 MIT License 授權，歡迎自由使用、修改與散布。

透過本專案取得的資料本身另依政府資料開放授權條款第 1 版釋出，授權範圍與程式碼分開，使用前請自行確認符合該授權條款的要求（主要是註明出處）。