Korea Business Verify (KBV) — MCP 服务器

KBV 是一个托管的 MCP 服务器，可实时验证韩国企业 — 试点阶段完全免费。 提供 10 位韩国商业登记号（사업자등록번호）即可返回登记状态（active / suspended / closed）、税务类型，以及 —— 可选 —— 该号码是否与代表人姓名和开业日期匹配。数据实时来自 Korea National Tax Service (NTS)，并以干净、英文规范化的 JSON 返回。

无需账户、无需 API 密钥、无需安装 —— 只需将任何支持 MCP 的 agent 连接到一个 URL：

https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

专为对韩国公司进行 KYB / 尽职调查的 AI agent 和开发者而打造：采购、签约、支付、市场入驻。

快速事实

Related MCP server: korea-business-verify

连接你的 agent

Claude (claude.ai)

1. 设置 → 连接器 → 添加自定义连接器

2. URL：https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

3. 在聊天中启用连接器，然后询问：“检查韩国企业 124-81-00998 的状态。”

Claude Code (CLI)

claude mcp add --transport http kbv https://kbv-server-f7vfitmlkq-du.a.run.app/mcp

ChatGPT

1. 设置 → 连接器（需要支持连接器 / 开发者模式的相关套餐）

2. 添加 URL 为 https://kbv-server-f7vfitmlkq-du.a.run.app/mcp 的自定义 MCP 连接

3. 在对话中启用它，然后询问关于韩国商业登记号的问题。

Cursor

添加到 .cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）：

{
  "mcpServers": {
    "korea-business-verify": {
      "url": "https://kbv-server-f7vfitmlkq-du.a.run.app/mcp"
    }
  }
}

任何其他 MCP 客户端

使用上面的端点，传输方式为 Streamable HTTP。客户端必须发送 Accept: application/json, text/event-stream（标准 MCP 客户端会自动发送）。在浏览器中打开 /mcp 会返回 Method not allowed，这是设计使然 —— 浏览器发送 GET，MCP 使用 POST。如需可视化存活检查，请使用 /health。

工具

check_korean_business_status

通过 10 位商业登记号检查韩国企业的登记状态。

输入 — 允许使用连字符/空格；内部会进行规范化：

{ "business_number": "124-81-00998" }

输出（真实示例 —— Samsung Electronics）：

{
  "business_number": "1248100998",
  "status": "active",
  "status_code_raw": "01",
  "tax_type": "general",
  "closed_date": null,
  "checked_at": "2026-08-24T10:08:20.082Z",
  "source": "Korea National Tax Service (NTS)",
  "cache": false
}

字段参考：

• status: active | suspended | closed | not_registered

• tax_type: general | simplified | exempt | non_profit | unknown

• closed_date: ISO 日期（"2023-01-31"），仅适用于已关闭的企业，否则为 null

• checked_at: NTS 查询的 ISO 8601 UTC 时间戳

• cache: 仅当 NTS API 暂时不可用并返回了缓存结果（最长 24 小时）时为 true；此时 checked_at 表示原始获取时间

格式正确但未在 NTS 注册的号码会返回 "status": "not_registered"（这不是错误）。

verify_korean_business

验证商业登记号是否与提供的代表人姓名和开业日期匹配（KYB 身份核验），并在同一次调用中获取当前状态。

输入：

{
  "business_number": "124-81-00998",
  "representative_name": "홍길동",
  "opening_date": "1969-01-13",
  "address": "경기도 수원시"
}

• representative_name 和 opening_date（YYYY-MM-DD）为必填项。

• address 为可选项，有助于提高匹配精度。

• 姓名和地址应按照在 NTS 登记的韩文原文提供。

输出 —— 与上述结构相同，仅额外增加 identity_match：

{
  "business_number": "1248100998",
  "status": "active",
  "status_code_raw": "01",
  "tax_type": "general",
  "closed_date": null,
  "checked_at": "2026-08-24T10:08:23.483Z",
  "source": "Korea National Tax Service (NTS)",
  "cache": false,
  "identity_match": false
}

仅当 NTS 确认该商业登记号、代表人姓名和开业日期均与其记录一致时，identity_match 才为 true。

错误

错误以 MCP 工具错误的形式返回，并带有机器可读的 JSON 内容：

数据来源与许可

• 所有数据均通过韩国政府官方开放数据 API（data.go.kr：사업자등록정보 진위확인 및 상태조회 서비스）来自 Korea National Tax Service (국세청)，且每次请求实时查询 —— KBV 不存储企业数据库。

• 底层数据集按韩国政府开放数据政策发布，无使用限制（이용허락범위: 제한 없음），因此响应内容可自由用于商业用途并自由引用。

• KBV 将 NTS 返回的韩语、基于代码的响应规范化为上述稳定英文 JSON 结构；原始 NTS 载荷不会被透传。

• 新鲜度：查询直接命中 NTS 注册系统。新注册企业可能需要 1–2 个工作日才能出现在 NTS 系统中。

隐私

• 查询内容永远不会被记录日志。 商业登记号、代表人姓名和地址不会出现在任何服务器日志中，除了解答查询的官方 NTS API 外，不会被发送到任何地方。

• 服务器日志仅包含请求次数、结果和延迟指标。

• 存在一个短生命周期的内存缓存（最长 24 小时，键为哈希值），其唯一用途是让服务在 NTS 中断期间仍能应答请求；该缓存从未被共享或导出。

定价

• 目前免费，KBV 正处于试点阶段。不需要账户或密钥。

• 按调用计费（每次调用约 $0.02–$0.05，agent 可通过 x402 付费）计划在后续阶段推出；面向轻量使用的免费层预计会保留。

• 合理使用：上游 NTS 配额是共享的。在付费层推出之前，大量自动化流量可能会被限流。

常见问题

什么是韩国商业登记号？ 这是由 Korea National Tax Service 颁发给韩国境内每个注册企业的 10 位标识符（사업자등록번호，通常写作 123-45-67890）。

我可以检查一家韩国公司是否仍在运营吗？ 可以 —— 调用 check_korean_business_status；"status": "active" 表示该企业目前已注册并运营，"closed" 会包含关闭日期。

我可以在交易前验证韩国公司的身份（KYB）吗？ 可以 —— 调用 verify_korean_business，并提供商业登记号、代表人姓名和开业日期；identity_match: true 表示 NTS 确认三者全部匹配。

我需要 API 密钥吗？ 不需要。连接 MCP URL 并调用工具即可。

自托管 / 开发

服务器开放用于本地开发（Node.js ≥ 22、TypeScript、Express + 官方 MCP SDK）：

cp .env.example .env       # put your own data.go.kr DECODING key in NTS_SERVICE_KEY
npm install
npm run dev                # → http://localhost:8080  (MCP at /mcp)
npm test                   # vitest, upstream fully mocked — no network

部署指南（Google Cloud Run）：参见 DEPLOY.md。架构与设计规格：DESIGN.md。