firmproof

firmproof

firmproof は、フランス、スペイン、英国の公式登記簿に照らして企業を確認する、Fuentio のホスト型 MCP サーバーへの小規模なローカルブリッジです。公式 ID（フランスの SIREN、スペインの Registro Mercantil の登記簿シート、英国の Companies House 番号）を渡すと、登記記録を読み取り、オンボーディング用に企業を検証し、制裁リストと照合し、倒産状況、住所、VAT を確認し、経時的な変更を追跡できます。それぞれの回答には公式情報源が付属します。

このブリッジは登記データを独自に保持しません。ライブエンドポイントから取得した上流サーバーのツール一覧をそのままローカルで提供し、各ツール呼び出しを上流へ転送して、結果を変更せずに返します。

ツール

• lookup_company — 公式 ID を使って1社を検索します。ステータス、住所、法人形態、事業活動、情報源、確認日を返します。 必須項目：country（FR、ES、GB のいずれか）、identifier。
• search_companies — 企業名で検索します。1ページあたり10社を返し、それぞれに一致スコアが付きます。必須項目：query、country。
• get_company_history — 企業の登記記録のバージョンと、変更されたフィールドおよびその情報源を返します。 必須項目：country、identifier。
• verify_company — 結果、理由、確認項目、警告シグナル、監査担当者向けの証明コードを含む、登記情報に基づく検証を行います。必須項目：country、identifier。
• get_receipt — 証明コードを使って、以前の検証のレシートを取得します。必須項目：proof_code、format（normal または detailed）。
• resolve_company — 手元の記録が登記簿上の企業に該当するかを、根拠と候補の判定とともに判断します。必須項目：country。
• explain_match — 2つの登記記録が同一企業であるかどうかと、その理由を説明します。必須項目：left、right。
• what_changed — 指定日以降に企業で何が変わったかを返します。必須項目：entity_id、since。
• screen_company — 企業名を制裁リストと照合します。必須項目：country、identifier。
• check_insolvency — BODACC および BORME の倒産公告と状況を確認します。必須項目：country、identifier。
• check_address — 登録住所を公式住所データベースと照合して検証します。必須項目： country、identifier。
• get_graph — 企業グループを取得します。GLEIF の親会社と子会社を返します。必須項目： entity_id。
• report_issue — 公式情報源と照合して再確認できるよう、誤りや欠落のある回答を報告します。必須項目： subject、category、message。
• get_evidence — 企業情報の根拠を、フィールドごとに情報源とともに返します。必須項目： entity_id。
• check_vat — 企業の EU VAT 番号と、その取得方法を確認します（登録自体は確認しません）。 必須項目：country、identifier。
• watch_company — 独自の https エンドポイントを登録し、企業の登記記録に変更があったときに通知を受け取ります。必須項目：entity_id、callback_url。
• review_report — 企業の本人確認情報、事実情報、過去1年間の変更、すべての確認結果をまとめた、レビュー対応レポートを1つ生成します。必須項目：country、identifier。
• check_supplier_list — 2〜100社のサプライヤーを一括確認するか、開始済みのバッチを読み取ります。必須フィールドはありません。rows または batch_id を渡してください。
• list_coverage — 対応する国、ID 形式、公式情報源を一覧表示します。引数は不要です。

設定

• FUENTIO_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://api.fuentio.com/mcp です。 （この上書き用フックは、この再構築で独自に付加したものとして明示されています。）
• FUENTIO_API_KEY（任意）— 設定すると、すべての上流リクエストに X-API-Key: <key> ヘッダーが付与されます。 一部の上流ツールではキーが必要で、ベンダーから無料のキーを取得できます。未設定の場合、キーのヘッダーは送信されません。Authorization ヘッダーは一切送信されません。 （この転送機能も、再構築で独自に付加したものとして明示されています。元のインターフェースはキーなしの状態で取得されました。）

転送の仕組み

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

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

CLI

各ツールは、JSON 引数文字列を 1 つ受け取るサブコマンドとしても利用できます （引数を取らないツールでは省略してください）。

npx @reneturcios/firmproof lookup_company '{"country":"FR","identifier":"441639465"}'
npx @reneturcios/firmproof search_companies '{"country":"FR","query":"renault"}'
npx @reneturcios/firmproof verify_company '{"country":"GB","identifier":"00445790"}'
npx @reneturcios/firmproof list_coverage
npx @reneturcios/firmproof --version

終了コード：成功時は 0、isError 結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/firmproof mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "firmproof": {
      "command": "npx",
      "args": ["-y", "@reneturcios/firmproof", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/firmproof
docker run --rm ghcr.io/cloudcorprecords/firmproof --version

コンテナのデフォルトコマンドは mcp です。そのため、最初の 形式では stdio MCP サーバーが起動し、それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべて、スタブ化された JSON-RPC 上流サーバーに対して実行されます。実際のネットワーク呼び出しはありません。

ライセンス

MIT — LICENSE を参照してください。