coderegistry

---

The Code Registry がビジネスリーダー向けに提供する、エンタープライズグレードのコードインテリジェンスです。AI エージェント向けのネイティブで多機能な MCP サーバーが登場しました。Claude Desktop、Claude API、その他の MCP 対応クライアントから直接、デューデリジェンス、技術的負債、セキュリティの脆弱性、コード品質などについてコードベースを分析できます。

MCP サーバーとしてインストールする

MCP 対応クライアントの設定には、次の URL を使用してください。

https://integrator.app.thecoderegistry.com/api/ai/router

エージェントスキルとしてインストールする

一部の MCP クライアントやエディター（Cursor など）では、スキルがツールを使用する前に MCP サーバーの設定が必要です。

Cursor MCP サーバーの設定（例）

{
  "mcpServers": {
    "coderegistry": {
      "url": "https://integrator.app.thecoderegistry.com/api/ai/router"
    }
  }
}

この JSON を Cursor の MCP 設定で使用するか、integrations/cursor/config.json にある同じ例をコピーしてください。

Cursor／CallMcpTool の既知の制限と回避策

一部の Cursor ビルド（および MCP ツールを汎用の CallMcpTool の背後にラップする他のクライアント）では、実行時には引数が受け付けられるにもかかわらず、arguments を省略した不完全なツールスキーマが表示される場合があります。

The Code Registry のツールを使用する際に CallMcpTool を使う場合は、必ず必須パラメーターを arguments フィールドに渡してください。

この動作を解消できることが多いプロンプトのヒント：

Use the CallMcpTool with the arguments field to pass the required parameters.

ラッパー呼び出しの形式の例：

{
  "server": "coderegistry",
  "toolName": "create_project",
  "arguments": {
    "user_id": "<user_id>",
    "name": "My Project"
  }
}

続いて、スキルをインストールします。

npx skills add The-Code-Registry/mcp-server

code-registry スキルは、この MCP サーバーを正しく使用するための追加のコンテキストと手順をクライアントの AI エージェントに提供します。内容は次のとおりです。

• 推奨されるツールの流れ（create_account -> create_project -> create-code-vault -> ポーリング）
• 初回分析と再分析における完了ルール（スナップショットレポートと比較レポート）
• 再試行／バックオフの動作と、LOCAL_AGENT のフォローアップに関するガイダンス

これは何ですか？

これはホスト型 MCP サーバーです。AI エージェントは会話から離れることなく、アカウントの作成、プロジェクトの管理、コードの分析、分析結果の取得を行えます。コードに関する迅速で信頼性の高い分析結果と、明瞭なレポートを必要とするビジネスリーダー（M&A 担当者、CTO、VC、取締役会メンバー）向けに設計されています。

あらゆるコードベースを分析でき、コードの量に応じて最短 30 分で結果が用意されます。分析が完了すると、結果を含む PDF レポートがユーザーに自動でメール送信されます。また、AI エージェントは結果が用意でき次第取得できるため、ユーザーとの会話に表示したり、グラフ、チャート、レポートなどを生成したりできます。

MCP とは？

Model Context Protocol（MCP）は、AI アシスタントがデータソースやツールに安全に接続できるようにするオープン標準です。詳しくはmodelcontextprotocol.ioをご覧ください。

MCP プロトコルのサポート

このサーバーは、次の機能を含む MCP JSON-RPC 2.0 の全フローをサポートしています。

• initialize
• tools/list
• tools/call
• resources/list および resources/read
• prompts/list および prompts/get

前提条件

• MCP 対応クライアント（Claude Desktop、Claude Code、または独自の実装）
• LOCAL_AGENT の場合：マシンに Docker がインストールされていること
• GIT ソースの場合：適切なアクセス権がある Git リポジトリの URL
• コード分析とソフトウェアメトリクスに関する基本的な理解

既存のアカウント

ユーザーがすでにCode Registryアカウントを持っている場合は、ウェブアプリでAPIキーを生成し、X-API-Keyヘッダー経由で直接使用できます（推奨）。MCPクライアントでカスタムヘッダーを設定できない場合は、ツールの引数でapi_keyを渡してください。

機能

• セットアップ不要：エージェントはアカウントを自動作成できます。必要なのはメールアドレス、氏名、チーム名または会社名だけです
• プライバシー優先：LOCAL_AGENTコードソースタイプを使用すると、コードはマシン上に保持され、送信されるのは結果を含む匿名化されたZIPファイルのみです
• プランに応じた分析：無料アカウントではコードの同期と概要レベルの結果の取得が可能です。有料プランでは、すべての検出結果データとプレミアム出力が利用できます
• 経営層向けレポート：PDFレポートがユーザーに自動でメール送信され、技術者以外の関係者にもそのまま共有できます
• 複数のソース：ローカルリポジトリまたはコードを含むフォルダー、GITリポジトリ、ファイルアーカイブ

AI エージェントまたはシステム向けのプロンプト例

MCP サーバーを設定したら、AI エージェントまたはシステムに次のような質問をできます。

• 「The Code Registryを使ってこのコードベースを分析し、見やすく結果を提示してください。」
• 「The Code Registryでこのプロジェクトのコードを再分析し、前回の分析から何が変わったかを教えてください。」
• 「Code RegistryアカウントからProject Xの最新の分析結果を取得して、提示してください（APIキーはこちらです：XXX）。」

MCP Protocol クイックスタート

0) 初期化（推奨）

{
  "jsonrpc": "2.0",
  "method": "initialize",
  "params": {
    "protocolVersion": "2024-11-05",
    "capabilities": {}
  },
  "id": 1
}

1) アカウントを作成

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_account",
    "arguments": {
      "email": "[email protected]",
      "name": "User Name",
      "team_name": "Example Org",
      "integrator_id": "agent-name"
    }
  },
  "id": 2
}

レスポンス：api_key、team_id、user_idが返されます（JSONとしてresult.content[0].text内に含まれます）。APIキーを安全に保存し、その後のすべてのリクエストでX-API-Keyヘッダー経由で指定してください。

2) プロジェクトを作成

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create_project",
    "arguments": {
      "user_id": "<user_id>",
      "name": "My Project",
      "description": "Optional"
    }
  },
  "id": 3
}

3) コードボルトを作成（推奨：LOCAL_AGENT）

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "create-code-vault",
    "arguments": {
      "project_id": "<project_id>",
      "user_id": "<user_id>",
      "name": "My Code Vault",
      "source_type": "LOCAL_AGENT"
    }
  },
  "id": 4
}

**レスポンス：**ローカルで実行するDockerコマンドを含むnext_steps.commandsが含まれます。

4) 結果をポーリング

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get-code-vault-results",
    "arguments": { "vault_id": "<vault_id>" }
  },
  "id": 5
}

**注：**結果は通常、コードベースのサイズに応じて30分から数時間で準備できます。指数バックオフを使ってポーリングしてください。

5) レポートURLを取得

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get-code-vault-reports",
    "arguments": { "vault_id": "<vault_id>" }
  },
  "id": 6
}

**注：**PDFレポートは分析の完了後に生成され、ユーザーに自動でメール送信されます。

既存のコードボルトを再分析

既存のコードボルトを再分析するには、次の手順を実行します。

1. reanalyze-code-vaultを呼び出します
2. 元のソースタイプがLOCAL_AGENTの場合は、LOCAL_AGENTを再度実行します
3. 通常どおり、同じ概要／結果／レポート取得ツールをポーリングします

重要：再分析が始まると、get-code-vault-summary、get-code-vault-results、get-code-vault-reportsが返すのは新しいバージョンのみです。以前のバージョンのデータには、これらのツールからアクセスできなくなります。

ユースケース

M&Aデューデリジェンス

買収候補の技術的リスク、セキュリティ脆弱性、アーキテクチャ上の懸念を迅速に評価します。examples/use-cases/due-diligence.mdを参照してください。

技術的負債の分析

ポートフォリオ全体の技術的負債を監視し、時間の経過に伴う改善を追跡します。examples/use-cases/tech-debt-analysis.mdを参照してください。

セキュリティ監査

問題が深刻化する前に、セキュリティ脆弱性とコンプライアンス上の問題を特定します。examples/use-cases/security-audit.mdを参照してください。

ポートフォリオの監視

投資ポートフォリオ内の複数の企業にまたがるエンジニアリング指標を追跡します。examples/use-cases/portfolio-monitoring.mdを参照してください。

設定

クライアントごとの設定については、integrations/を参照してください。

• Claude Desktop - デスクトップアプリの設定
• Claude API - Python／TypeScriptの例を含むAPI連携
• Cline - VS Code拡張機能のセットアップ
• Cursor - Cursor IDEとの連携
• カスタムエージェント - 独自のMCPクライアントを構築

エージェントスキル（任意）

このリポジトリには、MCP サーバーに関する追加のコンテキストと具体的な操作手順（ツールの実行順序、ポーリングのライフサイクル、完了ルール、結果の解釈方法）をエージェントに提供する、再利用可能なエージェントスキル skills/code-registry が含まれています。

• スキルのエントリーポイント：skills/code-registry/SKILL.md
• ライフサイクルの詳細：skills/code-registry/references/vault-lifecycle.md
• 解釈ガイダンス：skills/code-registry/references/result-interpretation.md
• ポーリング用ヘルパースクリプト：skills/code-registry/scripts/poll_vault_status.py

code-registry フォルダーをエージェントのスキルディレクトリにインストールし、通常どおりエージェントを実行してください。

• Codex：$CODEX_HOME/skills/
• Claude Code：~/.claude/skills/
• Cursor のプロジェクトローカル：.cursor/skills/

使い方の詳細とスクリプトの例については、skills/README.md を参照してください。

料金プラン

• 無料プラン：最大 100,000 行のコードに対応します。アカウントの作成、プロジェクト／コード保管庫の管理、コードの同期、要約レベルの MCP 出力が含まれます。
• 有料プラン：詳細な分析データと、検証バッジ、公開検証ページ、1,000 点満点の Code Score、その他の高度な機能をご利用いただけます。有料プランでは、詳細データを取得する MCP ツール get-security-issues、get-code-smells、get-git-history、get-contributors、get-components、get-code-iq-automated-queries、get-the-code-score も利用できます。検証専用（VerifyYourCode）プランでは、これらのツールは利用できません。
• エンタープライズ：個別の料金設定や大口割引については、thecoderegistry.com までお問い合わせください。

すべてのプランで利用できます：

• アカウントと API キーの管理
• プロジェクトとコード保管庫のライフサイクルツール
• LOCAL_AGENT、GIT、FILE_ARCHIVE による取り込み

ドキュメント

• 入門ガイド：docs/getting-started.md - 手順を追ったガイド
• API リファレンス：docs/api-reference.md - アクションの完全なリファレンス
• 認証：docs/authentication.md - API キーの管理
• ファセット用語集：docs/facets.md - 結果に含まれる分析ファセットの定義
• トラブルシューティング：docs/troubleshooting.md - よくある問題と解決策
• アーキテクチャ：docs/architecture.md - システム設計の概要
• スキルガイド：skills/README.md - Code Registry エージェントスキルのインストールと使い方

The Code Registry MCP サーバーを利用する理由

M&A の専門家向け：

• 技術デューデリジェンスを迅速に実施できます（数時間で完了し、数週間かかりません）
• 手作業でコードをレビューする必要はありません
• 経営幹部にもわかりやすい PDF レポートを提供します
• 客観的な技術リスク評価が可能です

CTO および技術リーダー向け：

• ポートフォリオ全体の技術的負債を監視できます
• セキュリティの脆弱性を追跡できます
• コードベースの複雑さを把握できます
• データに基づく技術的な意思決定ができます

VC および取締役向け：

• 投資先企業の技術リスクを評価できます
• エンジニアリング指標を継続的に追跡できます
• 客観的な技術的知見を得られます
• 投資先企業の CTO を支援できます

サポート

• メール：[email protected]
• 課題：バグ報告や機能リクエストには GitHub Issues をご利用ください
• ウェブサイト：thecoderegistry.com

ライセンス

詳細については、LICENSE ファイルを参照してください。

貢献

皆さまからの貢献を歓迎します！ガイドラインについては、CONTRIBUTING.md を参照してください。

---