legal-public-api-mcp

課題：AIに法令や立法趣旨を聞くと、条文の文言・改正時点・国会答弁を記憶で答えてしまい、一次情報で裏付けられない。公的APIは揃っているが、APIごとに仕様もキーの扱いもばらばらで、AIからそのまま使えない。

解決：e-Gov法令・国会会議録・法人番号の3つの公的APIを、1つのMCPサーバにまとめた。Claudeが条文（過去時点を含む）・国会答弁・契約相手の法人情報を一次情報から直接引き、出典つきで答えられるようにする。

ツール（10個）

設計上の工夫：

• 条文は e-Gov の elm パラメータで該当条だけを取得する（全文を取らない）ため、1リクエストのCPU時間は数ms程度。

• 法令は名称・略称・法令ID・法令番号のどれでも指定可能。e-Gov に略称登録がない実務略称（個情法・下請法・特商法など）は src/aliases.ts で補完。

• 条番号は「415」「第四百十五条」「3の2」などの表記ゆれを吸収。

• 法人番号はチェックデジットを検証してから照会（転記ミスを先に弾く）。

• 各ツールの応答に出典表示を付ける。

Related MCP server: Houki e-Gov MCP Server

デプロイ手順

前提：Node.js 20 以上、Cloudflare アカウント。

npm install

# 1. Cloudflare にログイン（ブラウザで承認）
npx wrangler login

# 2. シークレットを登録（値は対話入力。コードや設定ファイルには書かない）
openssl rand -hex 32            # ← 出力をMCP接続用トークンとして控える
npx wrangler secret put MCP_AUTH_TOKEN
npx wrangler secret put HOUJIN_APP_ID   # 国税庁から届いた13桁。届くまでは未登録でよい（法人番号ツールだけが「未設定」と返す）

# 3. デプロイ
npm run deploy
# → https://legal-public-api-mcp.<アカウント名>.workers.dev が払い出される

# 4. 稼働確認
curl https://legal-public-api-mcp.<アカウント名>.workers.dev/health   # {"ok":true}

MCP_AUTH_TOKEN が未登録のままだと、サーバは全リクエストを 503 で拒否する（認証なしで公開されるのを防ぐため）。

Claude への登録

Claude Code

claude mcp add --transport http --scope user legal-public-api \
  https://legal-public-api-mcp.<アカウント名>.workers.dev/mcp \
  --header "Authorization: Bearer <MCP_AUTH_TOKEN の値>"

claude.ai（カスタムコネクタ）

このプロトタイプは固定トークン方式のため、claude.ai のコネクタにはそのまま登録できない。claude.ai から使うには OAuth への対応が必要（次の段階の作業）。

ローカル開発

cp .dev.vars.example .dev.vars
node test/mock-houjin.mjs &      # 法人番号APIのモック（ポート8799）
npm run dev                       # http://127.0.0.1:8787/mcp
node test/smoke.mjs               # 全ツールを呼び出して確認（e-Gov・国会会議録は実APIに接続）
npm test                          # 単体テスト
npm run typecheck

トラブルシューティング

• Windows版Claude Codeで InvalidHTTPResponse になる：ウイルス対策ソフトのHTTPS検査（AVGのウェブ シールドで確認）が応答を書き換えている。curl.exe やブラウザでは届くのにClaude Codeだけ失敗する場合はこれ。AVGなら［設定］→［一般］→［例外］で https://<サーバのURL>/* を例外に追加すると解消する。

利用規約・運用上の注意

• 法人番号のアプリケーションID：第三者への譲渡・貸与・開示は禁止（法人番号システムWeb-API機能利用規約 9条1項5号）。IDは Workers のシークレットにのみ置き、応答・ログ・キャッシュキーには含めていない。このサーバを他人に使わせる場合は「IDの貸与」と評価されないよう、ツールを目的別に絞った現在の形を維持し、生のリクエストを素通しする機能は追加しない。

• 国会会議録：機械的なアクセスは数秒の間隔を空けるよう求められているため、同一 isolate 内で3秒間隔に直列化し、結果を6時間キャッシュしている。ただし isolate をまたいだ制御はしていない（利用者が少ないうちは問題にならない想定）。発言の著作権は原則として発言者に帰属する（公開の場での政治上の演説・陳述は著作権法40条1項により利用可能）。

• e-Gov：データが官報と異なる場合は官報が優先する。収録は2017年4月1日時点の条文以降。

• 照会内容の機密性：法人名の検索語（＝取引検討中の相手先）は Cloudflare のログに残りうる。業務で使う場合は、個人アカウントで運用するか会社アカウントで運用するかを決めてから使う。wrangler.jsonc の observability を無効にすればログ保存を止められる。

既知の制限・今後の候補

• 条文取得は本則のみ（附則・別表は未対応）。

• キャッシュは「isolate 内メモリ＋Cloudflare Cache API」の2層。workers.dev で Cache API が効くかは Cloudflare 側の仕様変更が続いているため、効かない場合もメモリキャッシュだけで動くようにしてある。

• 法人番号ツールはモックでのみ動作確認済み。実IDの登録後に houjin_get_by_number と houjin_search_by_name を実データで確認すること。

• claude.ai 対応のための OAuth は未実装。

ライセンス

MIT License（LICENSE）。各公的APIの利用には、それぞれの提供元の利用規約が適用される。