Tools MCP Server

mcp-tools

日本の公開データを提供するリモートMCPサーバー（Streamable HTTP・Cloudflare Workers）。Claude Connectors Directory と ChatGPT Apps Directory への掲載を目的とする。

仕様・進捗は mcp-tools-spec.md を参照。

ツール

すべて読み取り専用（readOnlyHint: true）。外部通信は api.houjin-bangou.nta.go.jp と www.kkj.go.jp のみ。

登録支援機関データの更新

登録簿は随時更新される（2026-10 時点で月に複数回）。Worker から直接取得せず、生成済みJSONを同梱している。理由は2つ。(1) 配布元が既定のUAを403で拒否する (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 等）：Streamable HTTP のリモートサーバーとして上のURLを登録する。

公式 MCP Registry の登録名は io.github.takaratomita/mcp-tools（定義は server.json）。

エンドポイント

開発

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 等のannotationがある
• プライバシーポリシー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）にログインし、individual または business の本人確認を完了
• 法人番号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を利用