MCP Server

🚀 The Code Registry MCP サーバー

The Code Registryによるエンタープライズ級のコードインテリジェンス。AIエージェント向けのネイティブで機能充実したMCPサーバーが搭載されています。

🚀 クイックスタート

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ビルド（および一般的なCallMcpToolの背後にMCPツールをラップする他のクライアント）では、argumentsが省略された不完全なツールスキーマが表示される場合がありますが、ランタイムではこれを受け入れます。 The Code Registryのツールでは、CallMcpToolを使用する際には常にargumentsフィールドに必要なパラメータを渡してください。 この動作を修正するためのプロンプトヒント： CallMcpToolを使用して、argumentsフィールドに必要なパラメータを渡してください。 ラッパー呼び出しの例：

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

次に、スキルをインストールします。

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

code-registryスキルは、クライアントAIエージェントにこのMCPサーバーを正しく使用するための追加のコンテキストと指示を提供します。これには以下が含まれます。

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

✨ 主な機能

• ゼロセットアップ：エージェントは自動的にアカウントを作成できます。必要なのはメールアドレス、名前、チーム/会社名だけです。
• プライバシー重視：LOCAL_AGENTコードソースタイプを使用すると、コードはあなたのマシン上に保持され、結果の匿名化されたzipファイルのみが送信されます。
• 包括的な分析：セキュリティ、複雑性、言語、ファイルタイプ、コード品質、ライセンス、技術的負債など。
• エグゼクティブにやさしいレポート：PDFレポートが分析完了後に自動的にユーザーにメールで送信され、非技術的な関係者にも使いやすいです。
• 複数のソース：ローカルのリポジトリまたはコードフォルダ、GITリポジトリ、またはファイルアーカイブ。

💻 使用例

基本的な使用法

MCPサーバーを構成した後、AIエージェントまたはシステムに次のような質問をすることができます。

- "The Code Registryを使用してこのコードベースを分析し、結果を見やすく表示してください。"
- "The Code Registryを使用してこのプロジェクトのコードを再分析し、前回の分析以来の変更点を表示してください。"
- "私のCode RegistryアカウントからProject Xの最新の分析結果を取得し、私に提示してください（これが私のAPIキーです：XXX）。"

高度な使用法

MCPプロトコルのクイックスタート手順は以下の通りです。

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": "user@example.com",
      "name": "User Name",
      "team_name": "Example Org",
      "integrator_id": "agent-name"
    }
  },
  "id": 2
}

応答：api_key、team_id、およびuser_idを返します（result.content[0].text内のJSONとして）。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は新しいバージョンのみを返します。以前のバージョンのデータは、これらのツールを介してはアクセスできなくなります。

📚 ドキュメント

• はじめに：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エージェントスキルのインストールと使用方法

🔧 技術詳細

MCPとは？

モデルコンテキストプロトコル（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アカウントを持っている場合、WebアプリでAPIキーを生成し、X-API-Keyヘッダーを介して直接使用できます（推奨）。MCPクライアントがカスタムヘッダーを設定できない場合は、代わりにツール引数にapi_keyを渡してください。

📄 ライセンス

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