Companies House MCP Server

🚀 英国公司注册处MCPサーバー

このサーバーはModel Context Protocol (MCP) サーバーで、英国の会社登記機関（Companies House）のAPIとやり取りするためのツールを提供します。AIエージェント（Claudeなど）が会社を検索し、プロファイルを取得し、役員を確認し、包括的なデューデリジェンスレポートを生成できるようになります。

🚀 クイックスタート

Dockerを使用した場合

1. イメージのビルド：

   docker build -t companies-house-mcp .
   

2. コンテナの実行：

   docker run -p 8001:8001 companies-house-mcp
   

3. Postmanでのテスト：

   • mcp_postman_collection.jsonをインポートします。
   • apiKey変数をあなたの会社登記機関のAPIキーに設定します。
   • http://localhost:8001/mcpにPOSTリクエストを送信します。

Claude Desktop（または他のMCPクライアント）での使用

MCPクライアントを設定してサーバーに接続します。このサーバーはHTTPトランスポートを使用しているため、HTTP MCPをサポートするアダプターまたはクライアントが必要になる場合があります。

ツール呼び出し例（JSON-RPC）：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "generate_company_report",
    "arguments": {
      "company_number": "00000006",
      "api_key": "YOUR_REAL_API_KEY"
    }
  }
}

✨ 主な機能

• 会社の検索：名前または番号で会社を検索できます。
• 会社プロファイル：詳細な会社情報（ステータス、住所、タイプ）を取得できます。
• 役員リスト：現役および退任した取締役や秘書の情報を取得できます。
• ファイリング履歴：提出された会計帳簿、確認書類、その他の文書にアクセスできます。
• 担保権（抵当権）：未決済および解消済みの担保権を確認できます。
• 破産手続き：破産手続きの有無を確認できます。
• 実質支配者（PSC）：実質的な支配力を持つ人物を特定できます。
• 包括的レポート：generate_company_report は上記のすべての情報をまとめた単一の要約を生成し、取締役の株主持分率も計算します。

🔧 技術詳細

アーキテクチャ

• トランスポート：HTTP（ステートレスでストリーミング可能） - パブリッククラウドでのデプロイに最適です。
• 認証：クライアント側のAPIキー注入（ユーザーが独自のキーを提供）。
• スタック：Python、FastMCP、Docker、Kubernetes。

前提条件

1. 会社登記機関のAPIキー：会社登記機関開発者ハブ から「ライブ」APIキーを取得する必要があります。
2. Docker（ローカルでの実行用）。
3. Kubernetes（デプロイ用、オプション）。

📚 ドキュメント

ツールリファレンス

Kubernetesでのデプロイ

1. デプロイ：

   kubectl apply -f k8s/deployment.yaml
   kubectl apply -f k8s/service.yaml
   

   （注：クライアント側のキーに依存する場合は、secret.yaml は必ずしも必要ありませんが、サーバー側のデフォルト設定に使用できます。）

2. アクセス： サービスはNodePortでポート 30001（またはK8s設定に応じてLoadBalancer）を介して公開されます。

セキュリティに関する注意事項

このサーバーはステートレスに設計されており、APIキーを保存しません。キーはリクエストごとに渡されるか、環境変数で設定されます（オプションのフォールバック）。本番環境ではHTTPSを介してキーを送信するようにしてください。