jpverify

jpverify

jpverify 是一个轻量的本地桥接服务，用于连接托管的 Hojincheck MCP 服务。该服务会根据日本政府开放数据核验日本企业。输入企业名称，它会返回法人编号候选项；输入 13 位法人编号，它会检查企业是否存在、读取其档案，或核验合格发票登记编号。它还会规范化日文地址，并回答有关日本节假日和工作日的问题。

该桥接服务自身不保存任何登记数据。它会在本地提供上游服务的工具列表，内容与从在线端点捕获的完全一致（工具标题和描述为日文，并按原样提供），并将每次工具调用转发到上游，原样返回结果。其功能仅涉及公开的商业登记数据：其中不包含个人数据筛查工具。

工具

• resolve_company — 将企业名称解析为法人编号候选项，并为每个候选项提供置信度分数和原因标签。必填：name。可选：address（按都道府县或市町村代码筛选）、include_closed（默认为 true）和 limit（默认为 10，最大值为 50）。数据来源：日本国税厅法人编号系统。
• verify_company — 核验 13 位法人编号（通过校验位验证），并返回企业是否存在、商号、总公司地址、法人类型和注销状态。必填：corporate_number。可选：include_history（默认为 false）。
• verify_invoice_number — 核验合格发票开具者登记编号（T 加 13 位数字），并返回登记状态、登记日期以及任何注销或失效信息。必填：registration_number。可选：on_date（YYYY-MM-DD 格式的有效性检查日期）和 include_history（默认为 false）。
• get_company_profile — 根据法人编号从 gBizINFO 读取企业档案，并提供各字段的数据来源和最后获取时间等元数据。必填：corporate_number。
• normalize_address — 规范化日文地址，将其拆分为都道府县、市町村和町域组成部分，解析町域标识符，并核对邮政编码。必填：address。可选：postal_code。
• jp_calendar — 计算日本节假日和工作日。必填：op，取值之一为 is_business_day、next_business_day、prev_business_day、add_business_days 和 list_holidays。其他参数（date、days、from、to、year_end_as_holiday）取决于所执行的操作。

配置

• HOJINCHECK_MCP_URL（可选）— 覆盖上游端点。默认为 https://hojincheck.com/mcp。（该覆盖接口是本次重建中标注的还原内容。）
• HOJINCHECK_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key> 标头，使用调用者自己的 Hojincheck 密钥（可从该服务免费获取）。未设置时，不会发送密钥标头。（标头名称和 Bearer 格式由原始项目的注册记录固定；通过此环境变量转发密钥是标注的还原内容——原始接口是在未提供密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26、 clientInfo name jpverify），然后发送 notifications/initialized 通知，最后发送携带调用方参数的 tools/call 请求，参数保持不变。当上游在响应 initialize 时返回 Mcp-Session-Id 标头，该值会随 此会话的每个后续请求一同发送；该会话在进程的整个生命周期内都会复用。 响应可能以普通 JSON 或服务器发送事件的形式返回；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标志。 失败情况——JSON-RPC 错误、非 2xx 状态码、无法读取的响应，或 无法完成的请求——会以 isError 结果返回，其 文本以 jpverify error: 开头（此呈现方式是本次重建自行添加的标注）。

CLI

每个工具也都是一个子命令，接受一个 JSON 参数字符串：

npx @reneturcios/jpverify resolve_company '{"name":"Example K.K."}'
npx @reneturcios/jpverify verify_company '{"corporate_number":"1234567890123"}'
npx @reneturcios/jpverify jp_calendar '{"op":"is_business_day","date":"2026-01-01"}'
npx @reneturcios/jpverify --version

退出代码：成功时为 0，结果带有 isError 时为 1， 用法错误时为 2。

MCP 服务

npx -y @reneturcios/jpverify mcp

MCP 客户端配置：

{
  "mcpServers": {
    "jpverify": {
      "command": "npx",
      "args": ["-y", "@reneturcios/jpverify", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/jpverify
docker run --rm ghcr.io/cloudcorprecords/jpverify --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他参数则会正常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全针对桩接的 JSON-RPC 上游运行，不会进行实时网络调用。

许可证

MIT——详见 LICENSE。