companies-house-screening-mcp

MCPホストから英国企業をCompanies House公開レジスタでスクリーニングします。サプライヤーリストの一括スクリーニング、ワンコールの企業スナップショット、リスクスコアではなく事実に基づくシグナルを提供します。

ステータス: 全6フェーズ中フェーズ6。 11のツール、実行中のサーバーから生成されCIでゲートされるドキュメント、ツール選択評価、ライブAPIから記録されたフィクスチャ。リリースパイプラインは構築済み。まだ公開されていません。

もう一つあります。知っておくべきです

companies-house-mcp by @aicayzer は2025年7月から存在し、v4.0.0で、積極的にメンテナンスされています。同じAPIをカバーしています。このプロジェクトは最初ではなく、そう主張もしません。

この2つは形が異なるため、どちらが適しているかは何をしているかによります。

幅広さを求めるなら彼らのものを使いましょう。 より多くのAPIを公開しています — 登録簿、免除、英国の事業所、役員の資格喪失 — そして重要なことに、提出された書類そのものをダウンロードできます。こちらは意図的にそうしていません: Companies Houseの文書APIはここでは対象外です。

閲覧ではなくスクリーニングを行うならこちらを使いましょう。 重要な違い:

11の決定がdocs/adrに文書化されています。明白な方法では進まなかったものも含めて。

インストール

npx -y companies-house-screening-mcp

ホスト設定:

{
  "mcpServers": {
    "companies-house": {
      "command": "npx",
      "args": ["-y", "companies-house-screening-mcp"],
      "env": { "COMPANIES_HOUSE_API_KEY": "your_key" }
    }
  }
}

またはDockerで — -i があり -t がないことに注意してください。TTYはJSON-RPCフレーミングを破壊するためです:

docker run --rm -i -e COMPANIES_HOUSE_API_KEY=your_key ghcr.io/OWNER/companies-house-screening-mcp

無料のAPIキーをdeveloper.company-information.service.gov.ukで取得してください: 登録し、Live環境に対してアプリケーションを作成し、RESTタイプのキーを作成します(ストリームキーも同じ方法で認証されますが、別のサービス用です)。

なぜ別のAPIラッパーなのか

これを構築する明白な方法は、エンドポイントごとに1つのMCPツールを置くことです。22の薄いパススルー、週末の仕事、そしてそれがほとんどの公開されたMCPサーバーです。また、3つの具体的な点で悪いです:

• すべてのツールスキーマは、タスクが必要とするかどうかに関係なく、毎ターンモデルのコンテキストに存在します。

• オーケストレーションをモデルに押し付けます。「このサプライヤーをオンボードしても安全か」は、検索、次にプロフィール、次に役員、次にチャージ、次に破産 — 5往復と、流れを失う5つの機会になります。

• Companies Houseのペイロードは、モデルが読まない構造を運びます — links、etag、kind、アイテムごとのETag、提出トランザクション配列、9キーの住所オブジェクト。それらを整形して取り除くと、想定ではなく実際に記録された応答に対して測定して、エンドポイントに応じて36%から72%節約できます(npm run measure)。

したがって、このサーバーは質問を中心に形作られた11のツールを公開し、そのうち2つ(company_snapshot と screen_companies)はサーバー側でファンアウトを行い、1つの派生オブジェクトを返します。取得ツールは企業番号を受け入れ、企業名を拒否します。名前が与えられるとモデルが番号を推測し、もっともらしい間違った企業番号は、下流で何も間違いとしてフラグを立てない実在の企業を返すためです。

ツール

完全なリファレンス: docs/tools。実例: docs/recipes — サプライヤースクリーニング、取締役の利益相反チェック、請求書検証、債務者リスク、競合他社の提出監視。

シグナルは事実であり、評価ではありません。 このサーバーは企業をスコアリングせず、取引しても安全かどうかを教えません — レジスタで見つけたものを、各観察の背後にある日付または名前とともに報告し、判断はコンテキストを持つ人に委ねます。空のシグナルリストは、リスト上の何も見つからなかったことを意味し、企業が健全であることを意味しません。ADR 7 に完全な論拠があります。

すべてのツールは readOnlyHint: true で注釈され、出力スキーマを公開し、verbose を受け取って整形されたペイロードと一緒に未加工のペイロードを返します。

ツールの内部

284のテスト、ネットワーク不要、実行にAPIキーは不要です。

設定

必要な変数は1つだけです。

開発

npm install
npm test
npm run typecheck
npm run build
npm run docs:generate

ドキュメントは生成され、CIで検証される。 docs/tools は実際のMCPクライアントを介して実行中のサーバーからレンダリングされ、docs/recipes 内のすべての呼び出しはページのビルド時に実行される。コミットされた内容と異なる場合 npm run docs:check は失敗し、CIはテストの前にそれを実行し、テストスイートも同じ比較を実行するため、変更がまだ目の前にあるうちに失敗が発生する。ツールの説明を変更したら再生成する必要がある。そうしないとビルドが赤くなる。

テストスイートは、ライブのCompanies House APIから記録されたフィクスチャに対してオフラインで実行されるため、新規クローンは何も設定せずに動作する。npm run record-fixtures で再記録できる — どの企業から取得したか、なぜそれらが選ばれたかは tests/fixtures/README.md を参照。

キーを取得したら、.env.example を .env にコピーして記入する:

npm run test:live

すべての開発コマンドはそのファイルを読み取る。シェルにすでに設定されているものは優先される。公開サーバーは、CH_ENV_FILE がファイルを指定しない限り .env を読み取らない — ホストはホストの作業ディレクトリでサーバーを起動し、たまたまそこにある .env を拾うのは、誤った認証情報を読み込む良い方法だからだ。

そのテストはCIで毎晩実行される。その役割は合格することではなく、Companies Houseがフィールドを変更した週に大きな音を立てて失敗することだ。そうすることで、ユーザーがドリフトに気づく前にフィクスチャが更新される。

ツール選択評価

このリポジトリのすべてのテストはツールが機能するかを問う。どのテストも問えないことが一つある。それは、人が実際の質問をしたときにモデルが正しいツールに手を伸ばすかどうかだ — ツールが正しく、高速で、完全にカバーされていても、説明が曖昧だったり別のツールと重複していたりすると、選択されないことがある。これは公開されたMCPサーバーで最も一般的な実際の欠陥だ。

npm run eval -- --repeat 3

OpenRouter または Anthropic API 経由で実行される — OPENROUTER_API_KEY または ANTHROPIC_API_KEY を設定する。デフォルトではOpenRouter上の z-ai/glm-5.2 を使用し、フルパスで約4ペンスかかる。なぜなら、料金が原因で誰も実行しない評価は何もしていないのと同じだからだ。ツールサポートのある任意のモデルを --model で指定して比較できる。

人が実際に使う言い回しで表現された14の質問を、最初に呼び出されたツール、禁止されたツールに触れたかどうか、引数が正しかったかどうか、そして最も重要なものとして、モデルが質問に含まれていない会社番号を捏造したかどうかで採点する。3回中2回合格したケースはフレーキーとして報告され失敗する。なぜなら、断続的な選択は2つの説明が重複していることを意味するからだ。

3つのモデル（GLM 5.2、Kimi K3、DeepSeek V4 Pro）で実行すると、93〜98%のスコアとなる。グラウンディンググループ — 会社名が与えられ番号がない場合、番号を思い出すのではなく検索する — は3つすべてで7/7合格。失敗は集中しており、そのうち3つはモデルではなく、私自身のツール説明の欠陥と、1つは評価自体の欠陥であることが判明した。

Companies Houseのキーは不要。何も実行されない。完全な比較とその結果は evals/README.md、推論は ADR 10 を参照。

設計ノート

11の決定が docs/adr に文書化されている:

1. アーキテクチャ決定の記録

2. スライディングウィンドウレートリミッターとその安全マージン

3. 例外ではなくデータとしてのエラー

4. キャッシュ、TTL、および古いフォールバック

5. 質問型ツール、および名前が拒否される理由

6. 結果ペイロードが2回送信される理由

7. スコアではなくシグナル

8. 部分的な結果、および何も静かに破棄しないこと

9. 生成されたドキュメント、CIで検証

10. ツール選択評価

11. タグ駆動リリース、証明付きで署名

スコープ

恒久的に読み取り専用。すべてのツールは readOnlyHint: true で注釈され、書き込みパスはない。企業に代わって文書を提出するCompanies Houseの提出APIは、リスクプロファイルが異なる別の製品であり、このサーバーのスコープ外である。ストリーミングAPIもスコープ外である。文書APIを通じて提出書類のPDFまたはiXBRLを取得することはフェーズ7であり、読み取り専用のままとなる。

ロードマップ

ライセンス

ソースコード: MIT。

このサーバーが返すデータは、Companies HouseがOpen Government Licence v3.0の下で公開しており、MITライセンスの対象ではない。再配布する場合は、OGLが要求する帰属表示を付けること:

政府機関の情報を含む。Open Government Licence v3.0の下でライセンスされている。

このプロジェクトはCompanies Houseとは提携しておらず、その承認も受けていない。