MCP Server

🚀 代碼註冊表MCP服務器

代碼註冊表為企業領導者提供企業級代碼智能服務。現在配備了原生的、功能齊全的MCP服務器，供AI智能體使用。可直接從Claude桌面版、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"
    }
  }
}

請在Cursor MCP設置中使用此JSON，或者從 integrations/cursor/config.json 複製相同的示例。

Cursor / CallMcpTool 已知限制及解決方法

一些Cursor版本（以及其他將MCP工具封裝在通用 CallMcpTool 後面的客戶端）可能會顯示不完整的工具模式，省略了 arguments，儘管運行時接受該參數。

對於代碼註冊表工具，在使用 CallMcpTool 時，始終在 arguments 字段中傳遞所需參數。

通常可以解決此問題的提示語： 使用帶有arguments字段的CallMcpTool傳遞所需參數。

示例調用格式：

{
  "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代碼源類型可將代碼保留在本地機器上，僅發送匿名的結果壓縮文件。
• 全面分析：涵蓋安全性、複雜性、語言、文件類型、代碼質量、許可證、技術債務等多個方面。
• 高管友好型報告：分析完成後，包含結果的PDF報告會自動通過電子郵件發送給用戶，方便非技術人員查看。
• 多數據源支持：支持本地代碼倉庫或文件夾、GIT倉庫或文件存檔。

📦 安裝指南

作為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"
    }
  }
}

請在Cursor MCP設置中使用此JSON，或者從 integrations/cursor/config.json 複製相同的示例。

Cursor / CallMcpTool 已知限制及解決方法

一些Cursor版本（以及其他將MCP工具封裝在通用 CallMcpTool 後面的客戶端）可能會顯示不完整的工具模式，省略了 arguments，儘管運行時接受該參數。

對於代碼註冊表工具，在使用 CallMcpTool 時，始終在 arguments 字段中傳遞所需參數。

通常可以解決此問題的提示語： 使用帶有arguments字段的CallMcpTool傳遞所需參數。

示例調用格式：

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

然後安裝技能：

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

💻 使用示例

基礎用法

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
}

響應：包含 next_steps.commands，其中包含需要在本地運行的Docker命令。

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 - 安裝和使用代碼註冊表智能體技能

🔧 技術細節

MCP協議支持

此服務器支持完整的MCP JSON-RPC 2.0流程，包括：

• initialize
• tools/list
• tools/call
• resources/list 和 resources/read
• prompts/list 和 prompts/get

先決條件

• 一個MCP兼容客戶端（Claude桌面版、Claude代碼版或自定義實現）
• 對於LOCAL_AGENT：本地機器上安裝了Docker
• 對於GIT源：具有適當訪問權限的Git倉庫URL
• 對代碼分析和軟件指標有基本瞭解

現有賬戶

如果用戶已經有代碼註冊表賬戶，他們可以在Web應用程序中生成API密鑰，並通過 X-API-Key 頭信息直接使用（推薦）。如果MCP客戶端無法設置自定義頭信息，則可以在工具參數中傳遞 api_key。

📄 許可證

詳情請參閱 LICENSE 文件。

🔗 支持與貢獻

支持

• 電子郵件：support@thecoderegistry.com
• 問題反饋：使用GitHub Issues進行bug報告和功能請求
• 網站：thecoderegistry.com

貢獻

我們歡迎貢獻！請參閱 CONTRIBUTING.md 獲取貢獻指南。