JP-Verify

jp-verify-mcp

一个用于 JP-Verify 的 MCP 服务。JP-Verify 是一个以英语为主的 API，用于验证日本公司：适格发票登记号码（T 号）、法人番号、英文名称和主要股东。

它是一个轻量级客户端。每次工具调用都会向 JP-Verify 的公共 API https://jp-verify.obolpay.xyz 发起一次 HTTPS 请求。此软件包不保存登记数据，也不会联系其他网站；它不会从日本国税厅或 EDINET 下载任何内容。

工具

工具	JP-Verify 端点	返回内容
verify_japanese_company	GET /v1/verify	登记状态和日期、法人番号、日文名称和地址、英文名称和地址（标明为官方名称或机器转写）
verify_japanese_companies_batch	POST /v1/verify	批量返回多个号码的信息：沙盒版和 Starter 密钥每次最多 100 个，Growth 最多 500 个，Reseller 最多 1,000 个。格式错误的号码会列在 invalid 下，且不收费
get_major_shareholders	GET /v1/shareholders	公司在 EDINET 提交的证券报告中的「大株主の状況」（主要股东情况）表，或 no_public_disclosure 声明。可选参数 as_of（YYYY-MM-DD）
find_japanese_company_by_name	GET /v1/resolve	根据公司名称查找候选法人番号（基于规则的精确匹配，不是模糊搜索）

这四个工具均为只读。每次成功返回的调用（HTTP 200）都会计为 JP-Verify 套餐中的一次查询；批量工具会对每个格式正确的号码计费一次。verify_japanese_company 和 get_major_shareholders 会在本地拒绝不符合 JP-Verify 自身格式规则或校验位规则的号码，不会发起请求；批量工具会按原样发送号码列表，JP-Verify 会将这类号码列在 invalid 下，且不收费。

每个结果都包含两部分：

• jp_verify_response：JP-Verify 返回的原始答复，包含 data_as_of、备注、免责声明和 attribution 字符串；
• metadata：端点、HTTP 状态、使用的是 API 密钥还是无密钥沙盒、配额响应头（limit、remaining、resets_at）以及数据来源。

HTTP 错误（400、401、404、429、503、5xx）和网络故障会作为工具错误返回，并附上一行说明。JP-Verify 不会对 400、401、404、429 或 503 响应收费。

安装和运行

需要 Python 3.10 或更高版本。

uvx jp-verify-mcp                # or: pip install jp-verify-mcp && jp-verify-mcp

从源代码检出目录安装：运行 pip install .，然后运行 jp-verify-mcp。

stdio（默认）

适用于 Claude Desktop、Claude Code（.mcp.json）、Cursor 及其他会启动本地服务的客户端：

{
  "mcpServers": {
    "jp-verify": {
      "command": "uvx",
      "args": ["jp-verify-mcp"],
      "env": { "JPVERIFY_API_KEY": "your key (optional)" }
    }
  }
}

省略 env 即可使用无密钥沙盒。

Streamable HTTP

jp-verify-mcp --transport streamable-http --host 127.0.0.1 --port 8000
# endpoint: http://127.0.0.1:8000/mcp  (stateless, JSON responses)

• 客户端可以在 X-API-Key 请求头中提供自己的密钥。该密钥仅会转发给 JP-Verify 用于本次调用，并且优先级高于 JPVERIFY_API_KEY。
• 绑定到环回地址时会自动启用 DNS 重绑定保护。对于公共主机名，请传入 --allowed-host your.host.name（可重复指定）。
• 在非环回地址上，如果设置了 JPVERIFY_API_KEY，服务将拒绝启动，因为所有未提供自有密钥的调用者都会使用该密钥。如果这是预期行为，请传入 --allow-shared-key。
• 沙盒额度按 IP 地址计算，因此无密钥的托管端点调用者会共享主机的额度。

配置

变量	默认值	含义
JPVERIFY_API_KEY	未设置	你的 JP-Verify API 密钥，将作为 X-API-Key 发送。未设置时使用无密钥沙盒
JPVERIFY_BASE_URL	https://jp-verify.obolpay.xyz	API 源地址。仅 localhost 支持普通 http://
JPVERIFY_TIMEOUT	20	每次请求的秒数（最多 120）

其他选项：jp-verify-mcp --help。

密钥和套餐

• 不使用密钥时，JP-Verify 会返回无密钥沙盒的答案。该服务按 IP 地址限制每日请求次数 （截至 2026-10-07，JP-Verify 文档说明每天可请求 50 次），且 JP-Verify 可能会更改或终止该服务 （其《条款》第 4 条）。
• 付费套餐及其价格公布在 JP-Verify 的法律声明中： https://jp-verify.obolpay.xyz/legal。如需密钥，请访问 https://jp-verify.obolpay.xyz 或发送邮件至 [email protected]。

数据、来源和署名

• 登记状态、法人番号、日文名称和地址来自日本国税厅（国税庁）发布的数据：国税庁適格請求書発行事業者公表サイト（合格发票开具方）和国税庁法人番号公表サイト（法人番号），由 JP-Verify 镜像并处理。这些数据并非由日本国税厅制作或担保。
• 英文名称：公司向法人番号登记簿申报了英文名称时，标记为 official-en；否则标记为 generated，即由机器转写生成，并非权威名称。大多数公司都没有申报英文名称。
• 个体经营者：仅返回编号、状态和日期，不返回名称或地址。
• 主要股东：公司向金融厅 EDINET 提交的「大株主の状況」表格，由 JP-Verify 提取。组织会列出名称；其他所有持有人（包括所有个人）均不显示名称，通常合并汇总（沙盒中始终如此）。只有提交有価証券報告書或半期報告書的公司才会发布此表格；对于其他公司，JP-Verify 会返回 no_public_disclosure，说明未发布信息的原因（并非声称该公司没有股东）。JP-Verify 的数据导入尚未完成时，部分申报方可能会显示 not_yet_available。JP-Verify 会单独启用此路由（其 /health 会报告 major_shareholders.enabled）；在启用之前，该工具会返回 route_not_enabled。
• JP-Verify 可能会在结果中加入金融厅的 EDINET 代码列表（PDL1.0）和 GLEIF LEI 数据（CC0 1.0）。
• 重新发布响应中的数据时，请保留其 attribution 字符串和 *_register 区块（JP-Verify《条款》第 5 条）。
• 这些是响应所注明日期时的登记信息，并非税务、法律、投资或所有权建议。若数据超出新鲜度期限，JP-Verify 会返回 503，而不会提供这些数据。

隐私

服务端仅向 JP-Verify 发送工具查询所需的信息（编号、名称、日期）以及 API 密钥（如有）。服务端不存储任何内容、不缓存、不重试调用，也不会自行添加日志；在默认日志级别（WARNING）下，不会记录请求内容。JP-Verify 的隐私声明：https://jp-verify.obolpay.xyz/v1/privacy。条款：https://jp-verify.obolpay.xyz/terms。

开发

python3 -m venv .venv && .venv/bin/pip install -e '.[test]'
.venv/bin/python -m pytest

测试不会连接到 JP-Verify：HTTP 请求会被模拟，或由 127.0.0.1 上的替代服务响应。

公司和联系方式

Yanagi the First Co., Ltd.（株式会社ヤナギtheファースト） · [email protected] · https://jp-verify.obolpay.xyz

许可证

本客户端采用 MIT 许可证。JP-Verify 服务的使用受其服务条款约束。

注册表

官方 MCP Registry 名称：xyz.obolpay/jp-verify。源代码：https://github.com/Hiroshi-Ichiyanagi/jp-verify-mcp