Korea Business Verify

io.github.wujinkim由 GitHub 账号 wujinkim 发布v0.1.1更新于 Oct 24, 2026

한국 사업자 검증 액션 MCP 서버 — 진위확인·휴폐업·과세유형·세금계산서 발행 가능 여부 (국세청 공공데이터 기반)

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

一个本地 MCP 服务器，让助手核验韩国事业者登记信息、查询营业状态与课税类型，并判断是否可开具税务发票。

可以做什么
核验事业者登记信息，比对事业者号码、代表者姓名与开业日期。查询营业中或停业状态、课税类型与停业日期。一次批量查询最多 100 个事业者号码的状态。判断是否可开具税务发票并给出依据。解释一般、简易、免税、非课税等课税类型的实务含义。
适用场景
适用于助手处理韩国供应商准入、经费或结算核对、发票准备，需要确认事业者号码真实且仍在营业的场景。也适合批量筛查供应商名单。
运行要求
通过 npx 或本地构建的 Node.js 包在本地运行。实时模式需要从公共数据门户申请国税厅服务密钥，通过 NTS_SERVICE_KEY 环境变量提供；核验与状态两项服务需分别申请密钥。无密钥时以演示模式运行，使用虚构的事业者号码。需要访问国税厅 API 的网络连接。
安装前请注意
服务密钥属于凭据，应仅保存在本地环境文件中。代表者姓名等核验输入会发送至国税厅 API，请勿提交无权共享的个人数据。状态查询结果会缓存 24 小时。结果仅供参考，不构成税务建议，也不具法律效力；正式证明须以 Hometax 签发的文件为准。清单声明的密钥变量名与 README 不一致，安装前请确认实际使用的名称。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Korea Business Verify，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

korea-business-verify

한국 사업자 검증 MCP 서버 — 진위확인·휴폐업·과세유형·세금계산서 발행 가능 여부를 AI 에이전트에게 도구로 제공합니다. 국세청 공공데이터포털 API 기반.

⚠️ 면책: 국세청 공공데이터 기준의 참고 결과이며 세무 자문이 아닙니다. 법적 효력이 있는 증명은 홈택스 발급 문서를 참조하세요.

도구 5종

도구설명
verify_business사업자등록정보 진위확인 (사업자번호·대표자명·개업일자 일치 여부)
check_business_status휴폐업 상태·과세유형·폐업일자 (호출 빈도 최다)
batch_check_status최대 100건 일괄 상태조회 (경비처리·정산 자동화)
check_invoice_eligibility세금계산서 발행 가능 여부 판정 + 근거 (면세/폐업 등)
explain_kr_tax_type과세유형(일반/간이/면세/비과세) 실무 의미 해설

빠른 시작 — DEMO (서비스키 불필요)

bash
npx -y korea-business-verify   # 서비스키 없으면 자동 DEMO 모드 (가상 사업자번호로 5종 도구 체험)

소스 빌드(개발자용): npm install && npm run build && DEMO_MODE=1 node dist/index.js

DEMO 가상 사업자번호 (체크섬은 유효하나 실제 존재하지 않는 번호):

번호상태과세유형
1111111119계속사업자일반과세자 → 세금계산서 가능
2222222227계속사업자면세사업자 → 계산서 대상
3333333336폐업자→ 발행 불가

라이브 모드 (실제 국세청 API)

  1. 서비스키 발급: docs/get-api-key.md (진위·상태 두 서비스 각각 신청 필요)
  2. .env 파일: 
    NTS_SERVICE_KEY=발급받은_서비스키
  3. 실행: node dist/index.js (키가 있으면 자동으로 라이브 모드)

Claude Desktop / Cursor 연동

claude_desktop_config.json (npx 권장):

json
{  "mcpServers": {    "korea-business-verify": {      "command": "npx",      "args": ["-y", "korea-business-verify"],      "env": { "NTS_SERVICE_KEY": "발급받은_키" }    }  }}
대안: 로컬 빌드 경로로 연동
json
{  "mcpServers": {    "korea-business-verify": {      "command": "node",      "args": ["/절대경로/korea-business-verify/dist/index.js"],      "env": { "NTS_SERVICE_KEY": "발급받은_키" }    }  }}

개인정보 보호 (무저장 원칙)

  • 서비스키는 사용자 로컬 .env에만 존재합니다. 본 서버는 이를 저장하거나 로그에 남기지 않으며, 국세청 API 인증을 위해서만 사용합니다.
  • 대표자명 등 진위확인 입력값은 요청 즉시 폐기됩니다. 진위확인을 위해 국세청 API로 전송되나, 응답 수신과 함께 어떤 로그·캐시·저장소에도 남기지 않습니다.
  • 캐시되는 것은 사업자번호와 상태조회 결과(24h)뿐입니다. 진위확인은 캐시하지 않습니다.
  • 사업자번호는 국세청 호출 전 체크섬 형식 검증으로 사전 필터링합니다.

신뢰성

  • API 장애(5xx·타임아웃·네트워크) 시 자동 재시도(지수 백오프, 3회). 인증/형식 에러는 즉시 명확한 에러 코드로 응답.
  • 모든 판정 결과에 basis(근거) 필드 동봉.

개발

bash
npm run build     # tscnpm test          # vitest (커버리지 96%)npm run lint      # eslint

라이선스

MIT

来源：README.md，提交 27cef29

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分