Thailand Data MCP

io.github.narinthon-so由 GitHub 帳號 narinthon-so 發布v0.1.2更新於 Oct 24, 2026

Thai data for AI agents: DBD company-registry lookup, address normalization, holidays, VAT/WHT.

已驗證STDIO僅桌面資料與分析商業與電商

概覽

AI 產生的概覽

讓助理查詢泰國公司登記資料、正規化泰文地址，並查閱假日與加值稅/扣繳稅參考資料。

可以做什麼
提供以 13 位法人編號查詢 DBD 官方企業檔案的工具（泰文/英文名稱、類型、狀態、登記日期、登記資本與實收資本、營業項目、登記地址），可將自由文字泰文地址解析為省/縣/區/郵遞區號及官方代碼並附信心程度，另提供全部 77 個府的双語標準清單、2025–2026 年泰國國定假日，以及加值稅與扣繳稅參考值。企業查詢為即時資料並在記憶體中快取 24 小時；地址正規化完全離線執行。
適用情境
適合助理需要處理泰國商業或行政資料的情境：用法人編號核實泰國公司、把凌亂的泰文地址結構化，或查詢泰國假日與加值稅/扣繳稅參考數值。
執行需求
以 npm 套件 thailand-data-mcp 的 stdio 本機程序執行，需要 Node.js 並執行建置步驟（pnpm install、pnpm build）。未宣告需要 API 金鑰或環境變數。企業查詢需要連線至上游 DBD 開放資料 API 的網路；地址、府清單、假日與稅務參考工具使用內建資料。
安裝前請注意
企業查詢會把所查法人編號傳送給上游 DBD 開放資料服務。回應帶有 DGA 開放政府授權要求的 attribution 欄位，不應移除。加值稅/扣繳稅工具僅供參考，不構成稅務建議，假日與稅務數值應核對官方公告。上游回傳 403/429 時，工具會回報「稍後重試」錯誤，而非謊稱「找不到」。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Thailand Data MCP，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

thailand-data-mcp-server

MCP server exposing Thailand data tools for AI agents: official company-registry lookups, Thai address normalization, public holidays, and VAT/withholding-tax reference.

Tools

ToolWhat it does
thai_company_lookupOfficial DBD registry profile by 13-digit juristic ID: TH/EN name, type, status, registration date, registered/paid-up capital, business objective, registered address. Live data, cached 24h.
thai_address_normalizeFree-text Thai address (TH/EN) → structured province/district/subdistrict/postcode with official codes, confidence level, ambiguity candidates, and street-part extraction. Fully offline.
thai_list_provincesCanonical list of all 77 provinces, bilingual, with codes.
thai_holidaysThai public holidays (2025–2026) with lunar-holiday flags.
thai_vat_referenceVAT rate/threshold/filing + common WHT rates and the 50 ทวิ certificate rule. Reference only, not tax advice.

Install & run

bash
pnpm installpnpm buildnode dist/index.js            # stdio (default)TRANSPORT=http PORT=3000 node dist/index.js   # streamable HTTP at /mcp (binds 127.0.0.1)

Claude Code registration:

bash
claude mcp add thailand-data -- node /path/to/thailand-data-mcp/dist/index.js

No API keys required.

Example

thai_company_lookup {"juristic_id": "0107536000315"}→ KASIKORNBANK PUBLIC COMPANY LIMITED | บริษัทมหาชนจำกัด | ยังดำเนินกิจการอยู่ | capital 30,246,820,970 THB | ...
thai_address_normalize {"address": "เลขที่ 5 ซอยสุขุมวิท 39 แขวงคลองตันเหนือ เขตวัฒนา กรุงเทพฯ"}→ province กรุงเทพมหานคร / district วัฒนา / subdistrict คลองตันเหนือ / 10110 | confidence: high | street: "เลขที่ 5 ซอยสุขุมวิท 39"

Data sources & licenses

  • Company registry: DBD Open Data openapi.dbd.go.th — used under the DGA Open Government License, which requires source attribution; every response therefore carries an attribution field. Do not strip it.
  • Geography: thailand-geography-data/thailand-geography-json (MIT) — bundled in data/.
  • Holidays / VAT: bundled reference data; verify critical values against official announcements (Royal Gazette, Revenue Department, Bank of Thailand).

Behavior notes

  • DBD lookups are cached in-memory for 24h (registry data changes slowly; also keeps request rates polite toward the WAF-fronted upstream).
  • The DBD API mislabels JSON responses as text/html; the client parses bodies regardless.
  • HTTP 403/429 from upstream = WAF/rate-limit → the tool returns a retry-later error, not a fabricated "not found".
  • "Not found" is only reported on the registry's explicit 1004 No data available status.

Development

bash
pnpm dev    # tsx watch

Stack: TypeScript, @modelcontextprotocol/sdk, Zod. No runtime dependencies beyond the SDK.

來源：README.md，提交 b7c0538

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分