Japan Public Data (法人番号・登録支援機関・官公需入札)

mcp-tools

提供日本公开数据的远程 MCP 服务（Streamable HTTP・Cloudflare Workers）。旨在收录到 Claude Connectors Directory 和 ChatGPT Apps Directory。

规格与进度请参阅 mcp-tools-spec.md。

工具

工具	内容	状态
lookup_corporate_number	日本国税厅法人番号公表网站 API。按法人番号（13 位）或法人名称搜索	已实现
search_support_orgs	出入国在留管理厅「注册支援机构登记簿」。按名称、所在地、服务语言搜索（随附数据：data/support-orgs.json）	已实现
search_local_govt_bids	官公需信息门户网站搜索 API（中小企业厅）。按关键词、都道府县、机构名称、公告日期搜索地方政府和国家机关的招标及公开征集信息	已实现

所有工具均为只读（readOnlyHint: true）。仅与 api.houjin-bangou.nta.go.jp 和 www.kkj.go.jp 进行外部通信。

更新注册支援机构数据

登记簿会不定期更新（截至 2026-10，每月更新数次）。Worker 不会直接获取数据，而是随附生成后的 JSON。原因有两个：(1) 数据发布方会以 403 拒绝默认 UA；(2) 每次请求都解析 2.6MB 的 Excel 对 Workers 来说负担过重。随附的 JSON 约为 5.0MB，gzip 压缩后约为 0.86MB，符合 Workers 免费计划的脚本大小上限（压缩后 3MB）。

pip install openpyxl
python3 scripts/build_support_orgs.py   # 从发布页面获取最新 Excel，并覆盖 data/support-orgs.json
npm test

代表者姓名列与工具用途无关，因此不会导入。名称和支援事务所名称字段会按登记簿中的原文返回。

使用方法（安装）

公开端点为 https://mcp-tools.takara0408103123.workers.dev/mcp。无需身份验证。

Claude Code：

claude mcp add --transport http mcp-tools https://mcp-tools.takara0408103123.workers.dev/mcp

Claude Desktop・claude.ai：在设置中的「连接器」→「添加自定义连接器」中输入上方 URL。

其他 MCP 客户端（Cursor・VS Code 等）：将上方 URL 注册为 Streamable HTTP 远程服务。

官方 MCP Registry 中的注册名称为 io.github.takaratomita/mcp-tools（定义见 server.json）。

端点

路径	内容
/mcp	MCP（Streamable HTTP・无状态・JSON 响应）
/privacy	隐私政策（/ 内容相同）
/health	健康检查

开发

npm install
npm test            # vitest
npm run typecheck
cp .env.example .dev.vars   # 填写 HOUJIN_APP_ID
npm run dev         # http://localhost:8787/mcp

运行确认示例：

curl -s -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  localhost:8787/mcp -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

部署（Cloudflare Workers）

1. npx wrangler secret put HOUJIN_APP_ID（lookup_corporate_number 所需。未注册时，其他 2 个工具仍可运行）
2. npm run deploy（默认使用 workers.dev。可选使用自定义域名，启用 wrangler.toml 中的 routes）
3. 确认 https://<host>/health 和 https://<host>/privacy 返回 200

已于 2026-10-19 部署到 https://mcp-tools.takara0408103123.workers.dev。目录收录要求不包括自定义域名，因此将继续使用 workers.dev（依据见规格说明第 5 章）。

收录检查清单

用于收录到 Claude Directory

• 已部署到公开 HTTPS（workers.dev；已确认可访问 /mcp）
• 已订阅付费 Claude 计划（Max；已于 2026-10-19 在提交页面确认）
• 已申请法人番号 API 的 appId，并注册到 wrangler secret（评审人员需要测试所有工具，因此提交前必须完成）
• tools/list 中的全部 3 个工具均包含 readOnlyHint 等注解
• 已准备隐私政策 URL（/privacy）
• 已注明支持联系方式（GitHub Issues）
• 从 https://claude.ai/directory/manage 的「MCP 连接器」提交（文案见 docs/listings.md）

用于收录到 ChatGPT Apps

• 已部署到公开 HTTPS（workers.dev）
• 登录 ChatGPT Platform（https://platform.openai.com/plugins），并完成个人或企业身份验证
• 已申请并注册法人番号 API 的 appId
• 已准备隐私政策 URL（/privacy）
• 提交时填写 CSP 定义（声明连接的域名。外部通信域名为 api.houjin-bangou.nta.go.jp 和 www.kkj.go.jp）
• 准备审查用测试提示词和预期结果
  • 「查询法人番号 7000012050002 对应的公司」→ 日本国税厅（东京都千代田区）
  • 「查找横滨市支持尼泊尔语的注册支援机构」→ 登记簿中的相关机构列表及来源
  • 「查找东京都的清洁业务招标信息」→ 最近 30 天的公告列表及来源
• 提交时通过官方指南重新确认最新要求

许可证

MIT。数据来源如下。

• 法人信息：日本国税厅法人番号公表网站
• 注册支援机构：出入国在留管理厅「注册支援机构登记簿」（公共数据利用规则第 1.0 版（PDL1.0）。经加工后使用）
• 招标及公开征集信息：使用官公需信息门户网站（https://www.kkj.go.jp/s/）的搜索 API