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 分