Thailand Data MCP

thailand-data-mcp-server

AI エージェント向けにタイのデータツールを提供する MCP サーバーです。公式の企業登記情報の照会、タイの住所の正規化、祝日、VAT／源泉徴収税の参照に対応しています。

ツール

ツール	機能
thai_company_lookup	13 桁の法人 ID による、公式 DBD 登記情報の照会です。タイ語／英語の名称、種類、ステータス、登録日、登録資本金／払込資本金、事業目的、登録住所を取得します。ライブデータで、24 時間キャッシュされます。
thai_address_normalize	自由形式のタイ語／英語の住所を、公式コード付きの都道府県／郡／町／郵便番号、信頼度、曖昧さの候補、道路部分の抽出情報を含む構造化データに変換します。完全にオフラインで動作します。
thai_list_provinces	全 77 県の標準リストを、コード付きでタイ語／英語の両方で提供します。
thai_holidays	月の祝日フラグ付きの、タイの祝日（2025～2026 年）を提供します。
thai_vat_reference	VAT の税率／基準額／申告、一般的な源泉徴収税率、および 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/ に同梱されています。
• 祝日／VAT：参照データを同梱しています。重要な値は、公式発表（Royal Gazette、Revenue Department、Bank of Thailand）で確認してください。

動作に関する注意事項

• 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 以外に実行時依存関係はありません。