内容
#泰国数据MCP服务器
MCP服务器，提供泰国数据工具，适用于AI代理：官方公司注册查询，泰国地址标准化，公共假期，增值税/预扣税参考。
## 工具
| 工具 | 功能描述 |
|---|---|
| `thai_company_lookup` | 通过13位法人编号查询官方工商登记信息：中文/英文名称，类型，状态，注册日期，注册/实缴资本，经营范围，注册地址。实时数据，缓存24小时。 |
| `thai_address_normalize` | 自由文本泰国地址（中文/英文）→ 结构化省/区/镇/邮政编码，附官方代码，置信度，模糊候选项，街道部分提取。完全离线。 |
| `thai_list_provinces` | 所有77个省份的规范列表，双语，附代码。 |
| `thai_holidays` | 泰国公共假期（2025-2026），附农历假期标志。 |
| `thai_vat_reference` | 增值税率/门槛/申报 + 常见预扣税率 和 50 ทวิ 证书规则。仅供参考，非税务建议。 |
## 安装与运行
```bash
pnpm install
pnpm build
node dist/index.js # 标准输入输出（默认）
TRANSPORT=http PORT=3000 node dist/index.js # 流式HTTP，绑定127.0.0.1
```
Claude 代码注册：
```bash
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 | 株式会社 | 仍在运营 | 资本 30,246,820,970 泰铢 | ...
```
```
thai_address_normalize {"address": "เลขที่ 5 ซอยสุขุมวิท 39 แขวงคลองตันเหนือ เขตวัฒนา กรุงเทพฯ"}
→ 省 กรุงเทพมหานคร / 区 วัฒนา / 镇 คลองตันเหนือ / 10110 | 置信度：高 | 街道： "เลขที่ 5 ซอยสุขุมวิท 39"
```
## 数据来源与许可
- **公司注册信息**： [DBD 开放数据](https://opendata.dbd.go.th/) `openapi.dbd.go.th` — 在 **DGA 开放政府许可** 下使用，需来源注明；因此每个响应都附带 `attribution` 字段，请勿删除。
- **地理信息**： [thailand-geography-data/thailand-geography-json](https://github.com/thailand-geography-data/thailand-geography-json) （MIT）— 打包在 `data/` 中。
- **假期 / 增值税**：打包参考数据；请与官方公告（《皇家公报》，税务总局，泰国央行）核实关键值。
## 行为说明
- DBD 查询结果缓存内存中 24 小时（注册数据变化缓慢；也保持对WAF前端上游请求的礼貌）。
- DBD API 错误地将 JSON 响应标记为 `text/html`；客户端会解析响应体。
- 来自上游的 HTTP 403/429 = WAF/速率限制 → 工具返回稍后重试的错误，非伪造的“未找到”。
- 仅当注册信息明确返回 `1004 No data available` 状态时，才报告“未找到”。
## 开发
```bash
pnpm dev # tsx 监听
```
技术栈：TypeScript， `@modelcontextprotocol/sdk`，Zod。除SDK外，无运行时依赖。
