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（任意）— 設定すると、呼び出し元自身の Hojincheck キー（サービスの無料キー）を使い、すべての上流リクエストに Authorization: Bearer <key> ヘッダーを付与します。未設定の場合、キーのヘッダーは送信されません。（ヘッダー名と Bearer 形式は、元のレジストリ記録に基づいて固定されています。この環境変数からキーを転送する機能は、ラベル付きの再現機能です。元のインターフェースはキーなしの状態で取得されました。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流サーバーとのストリーミング可能な HTTP セッションを開きます。まず JSON-RPC の initialize リクエスト（protocolVersion 2025-03-26、 clientInfo name jpverify）を送り、続いて notifications/initialized 通知を送り、その後、 呼び出し元の引数を変更せずに含めた tools/call リクエストを送ります。上流サーバーが Mcp-Session-Id ヘッダーを付けて initialize に応答した場合、その値は セッションの後続のすべてのリクエストに付与され、プロセスの実行中は 同じセッションが再利用されます。応答はプレーンな JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取られます。

成功した上流サーバーの結果は、上流サーバーが設定した isError フラグも含め、 そのまま返されます。 JSON-RPC エラー、2xx 以外のステータス、読み取り不能な応答、 または完了できないリクエストなどの失敗は、テキストが jpverify error: で始まる isError 結果として返されます（この表示は、 この再構築版独自のラベル付きの再現です）。

CLI

各ツールは、1 つの 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 を参照してください。