datawarehouse-dbd-mcp

MCP server สำหรับ datawarehouse.dbd.go.th ของกรมพัฒนาธุรกิจการค้า (DBD) — ค้นหาและดึงข้อมูลนิติบุคคลไทย, นิติบุคคลต่างประเทศ, งบการเงิน, รายชื่อกรรมการ, ผู้ถือหุ้น, สถิติการจดทะเบียน ฯลฯ เป็น tool ผ่าน Model Context Protocol.

An MCP server that wraps the public Thai Department of Business Development data-warehouse API as a clean set of tools. Documentation is primarily in Thai; code comments are in English.

คุณสมบัติ / Features

• 🔎 ค้นหานิติบุคคล ตามชื่อหรือเลขทะเบียน 13 หลัก
• 🏢 ดึงข้อมูลพื้นฐาน เช่น สถานะ, ที่ตั้ง, ทุนจดทะเบียน, ทรัพย์สิน, กำไรสุทธิ
• 👥 กรรมการ, ผู้ลงนาม, ผู้ถือหุ้น/หุ้นส่วน
• 📜 ประวัติการเปลี่ยนชื่อ, ทุนจดทะเบียน, การควบรวม/แปรสภาพ
• 💰 งบการเงิน (basic/charts/submit history)
• 🌏 นิติบุคคลต่างประเทศ ที่ได้รับใบอนุญาตในไทย
• 📊 สถิติการจดทะเบียน, การจัดอันดับ, รายงานรายพื้นที่
• 🏷️ TSIC (Thai Standard Industrial Classification) lookup
• 🤝 Supply chain / partner network จาก /partner endpoints
• 📈 Industry benchmarks ค่าเฉลี่ย/มัธยฐานรายอุตสาหกรรม

สถาปัตยกรรม / Architecture

DBD ใช้ Incapsula WAF + ส่งคำตอบเป็นซองเข้ารหัส AES-GCM. โครงสร้างของ MCP server นี้ออกแบบให้เป็น wrapper REST API ที่บางและเรียบง่าย:

src/
├── index.ts        เริ่ม MCP server (stdio transport)
├── session.ts      bootstrap session ครั้งเดียวด้วย Playwright headless
│                   ดึง Incapsula cookies + JWT แล้วใช้ Bun fetch ทำ request ต่อ
├── crypto.ts       ถอดรหัสซอง AES-GCM + HKDF-SHA256 + zlib inflate
├── tools.ts        นิยาม MCP tools พร้อมคำอธิบายภาษาไทย/อังกฤษ
└── api/
    ├── company.ts     /v1/company-profiles/* (search, directors, partners, …)
    ├── financial.ts   /v1/fin/* (งบการเงิน)
    ├── foreign.ts     /v1/foreign/* (นิติบุคคลต่างประเทศ)
    ├── biztype.ts     /v1/biztype/* (TSIC)
    ├── investment.ts  /v1/investment/* (การลงทุนต่างชาติ)
    ├── area.ts        /v1/area/* (รายพื้นที่)
    ├── stats.ts       /v1/stats/* (สถิติ)
    ├── bizpartner.ts  /v1/partner/* (supply chain)
    ├── bizopp.ts      /v1/bizopp/* (industry benchmarks)
    └── util.ts        ฟังก์ชันช่วย (split juristic ID เป็น 2 ส่วน)

Playwright ใช้แค่ตอน bootstrap session (ครั้งแรก) เพื่อผ่าน WAF challenge. หลังจากนั้นทุก request ไปยัง /api/* ใช้ Bun fetch ตรง — เร็ว, เบา.

การติดตั้ง / Installation

ต้องการ Bun v1.3+ และจะติดตั้ง Chromium ให้อัตโนมัติ สำหรับใช้ bootstrap session.

bun install
# postinstall จะรัน playwright install chromium ให้

ถ้าจำเป็นติดตั้ง Chromium ด้วยตนเอง:

bunx playwright install chromium

การใช้งาน / Usage

รันแบบ stdio

bun src/index.ts

ตั้งค่าใน Claude Desktop

แก้ไข ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "dbd": {
      "command": "bun",
      "args": ["/absolute/path/to/datawarehouse-dbd-mcp/src/index.ts"]
    }
  }
}

ตั้งค่าใน Claude Code

claude mcp add dbd -- bun /absolute/path/to/datawarehouse-dbd-mcp/src/index.ts

รายการ Tool ทั้งหมด / Tool reference

Tool	คำอธิบาย
search_juristic	ค้นหานิติบุคคลไทยจากชื่อ/เลข 13 หลัก
get_juristic_profile	ข้อมูลพื้นฐาน (สถานะ, ที่ตั้ง, ทุน, กำไร, ฯลฯ)
get_juristic_directors	รายชื่อกรรมการ
get_juristic_signatories	ผู้มีอำนาจลงนาม
get_juristic_objectives	วัตถุประสงค์การประกอบกิจการ
get_juristic_partners	ผู้ถือหุ้น / หุ้นส่วน
get_juristic_capital_history	ประวัติเปลี่ยนทุนจดทะเบียน
get_juristic_name_history	ประวัติเปลี่ยนชื่อ
get_juristic_mergers	การควบรวม / แปรสภาพ
get_juristic_liquidators	ผู้ชำระบัญชี
get_juristic_nationalities	สัดส่วนสัญชาติผู้ถือหุ้น
get_financial_basics	งบการเงินรายการสำคัญ (ระบุ fiscalYear ปี ค.ศ. เพื่อเจาะจง)
get_financial_submit_history	ประวัติการนำส่งงบการเงิน
get_financial_charts	ข้อมูลกราฟแสดงผลทางการเงิน
search_foreign_juristic	ค้นหานิติบุคคลต่างประเทศ
get_foreign_profile	ข้อมูลพื้นฐานนิติบุคคลต่างประเทศ
get_foreign_business_types	ประเภทธุรกิจที่ได้รับใบอนุญาต
get_foreign_directors	กรรมการนิติบุคคลต่างประเทศ
list_biztypes	รายการ TSIC ทั้งหมด
get_biztype	รายละเอียดประเภทธุรกิจ (TSIC) ตามรหัส
get_biztype_overview	overview ของประเภทธุรกิจ
get_area_summary	สรุปนิติบุคคลรายพื้นที่
get_register_stat	สถิติการจดทะเบียน
get_juristic_ranking	การจัดอันดับนิติบุคคล
get_industry_fin_benchmark	ค่าเฉลี่ย/มัธยฐานรายการการเงินรายอุตสาหกรรม
get_industry_fin_ratios	ค่าเฉลี่ย/มัธยฐานอัตราส่วนการเงินรายอุตสาหกรรม
get_supply_chain	เครือข่ายคู่ค้า (supply chain)

ตัวอย่าง / Examples

// ค้นหา "ปตท"
{
  "name": "search_juristic",
  "arguments": { "keyword": "ปตท" }
}

// ดึงข้อมูลพื้นฐาน PTT (เลขทะเบียน 0107544000108)
{
  "name": "get_juristic_profile",
  "arguments": { "juristicId": "0107544000108" }
}

// ดึงประวัติทุนจดทะเบียน
{
  "name": "get_juristic_capital_history",
  "arguments": { "juristicId": "0107544000108" }
}

ข้อจำกัด / Limitations

• Tier anonymous: server นี้ใช้ token แบบ ROLE_ANONYMOUS ที่ DBD เปิดให้ สาธารณะ. บาง endpoint จะคืนผลลัพธ์ว่าง ([] หรือ field เป็น null) สำหรับ ผู้ใช้ที่ไม่ได้ล็อกอิน. ข้อมูลภาพรวม/ค้นหา/งบการเงินรายการสำคัญยังใช้ได้
• Incapsula challenge: เปิด session ใหม่จะใช้เวลา 3–5 วินาที (โหลด Chromium ผ่าน WAF). หลังจาก warm-up แล้ว request ต่อ ๆ ไปเป็น HTTP fetch ปกติ; JWT จะรีเฟรชอัตโนมัติก่อนหมดอายุ
• Response encryption: response บาง endpoint เข้ารหัสเป็น envelope {kid,salt,iv,ct} AES-GCM + HKDF-SHA256, ถอดรหัสฝั่ง client (crypto.ts)
• ไม่ใช่ API ทางการ: เป็นการ wrap endpoint ภายในของหน้าเว็บ. ถ้า DBD เปลี่ยนโครงสร้าง เซิร์ฟเวอร์นี้อาจต้องปรับตาม

License

MIT. โครงการนี้ไม่ได้รับการสนับสนุนหรือร่วมมือกับกรมพัฒนาธุรกิจการค้าโดยตรง — เป็นเครื่องมือ open-source ที่ช่วยให้นักพัฒนาเข้าถึงข้อมูลสาธารณะของ DBD ได้ง่ายขึ้น