关于 Thailand Data MCP
Thailand Data MCP 为需要泰国公司、地址、假日和税务参考数据的 AI Agent 提供 MCP 服务。它结合实时 DBD 登记查询、离线地址规范化和内置参考数据。
主要功能
- 01按法人编号查询 DBD 公司信息
- 02规范化泰文地址并提供置信度
- 03提供带代码的双语府列表
- 04查询 2025–2026 年公共假日
- 05提供增值税和预扣税参考
适用场景
- 01核查泰国公司的登记资料
- 02将自由格式泰文地址转换为结构化字段
- 03查询假日日期或税务参考
MCP 相关
向 MCP 客户端提供五种泰国数据工具,包括公司查询、地址规范化、府列表、假日查询和增值税参考。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
5收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| juristic_id | string | 是 | 13 位泰国法人注册号,例如 '0107536000315'。印在发票、合同和公司文件上;与公司的税号相同。 |
详细介绍
thailand-data-mcp-server
为 AI Agent 提供泰国数据工具的 MCP 服务:官方公司注册信息查询、泰语地址标准化、公共假日以及增值税/预扣税参考信息。
工具
| 工具 | 功能 |
|---|---|
thai_company_lookup | 根据 13 位法人 ID 查询官方 DBD 注册档案:泰语/英语名称、类型、状态、注册日期、注册/实缴资本、经营目标、注册地址。实时数据,缓存 24 小时。 |
thai_address_normalize | 将自由格式的泰语地址(泰语/英语)转换为结构化的府/县/区/邮政编码,并提供官方代码、置信度、歧义候选项和街道部分提取结果。完全离线。 |
thai_list_provinces | 全部 77 个府的规范列表,含双语名称和代码。 |
thai_holidays | 泰国公共假日(2025–2026),并标注农历节日。 |
thai_vat_reference | 增值税税率/起征点/申报信息,以及常见预扣税税率和 50 ทวิ 证明规则。仅供参考,不构成税务建议。 |
安装与运行
pnpm install
pnpm build
node dist/index.js # stdio (default)
TRANSPORT=http PORT=3000 node dist/index.js # streamable HTTP at /mcp (binds 127.0.0.1)
Claude Code 注册:
claude mcp add thailand-data -- node /path/to/thailand-data-mcp/dist/index.js
无需 API 密钥。
示例
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"
数据来源与许可
- 公司注册信息:DBD Open Data
openapi.dbd.go.th— 依据 DGA Open Government License 使用,该许可证要求注明来源;因此每个响应都包含attribution字段。请勿移除该字段。 - 地理数据:thailand-geography-data/thailand-geography-json(MIT)— 随项目附带于
data/中。 - 公共假日/增值税:随项目附带的参考数据;重要数值请以官方公告为准(《皇家公报》、税务局、泰国央行)。
行为说明
- DBD 查询会在内存中缓存 24 小时(注册信息变更较慢;同时也能以适当频率向由 WAF 防护的上游发送请求)。
- DBD API 将 JSON 响应错误标记为
text/html;客户端无论如何都会解析响应正文。 - 上游返回 HTTP 403/429 = WAF/速率限制 → 工具会返回稍后重试的错误,而不会伪造“未找到”结果。
- 只有注册机构明确返回
1004 No data available状态时,才会报告“未找到”。
开发
pnpm dev # tsx watch
技术栈:TypeScript、@modelcontextprotocol/sdk、Zod。除 SDK 外无运行时依赖。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。