coderegistry

---

The Code Registry 为企业领导者提供企业级代码智能。现已推出面向 AI Agent 的原生全功能 MCP 服务。可直接通过 Claude Desktop、Claude API 和其他兼容 MCP 的客户端，分析代码库以开展尽职调查、评估技术债务、安全漏洞、代码质量等。

安装为 MCP 服务

配置任何兼容 MCP 的客户端时，请使用此 URL：

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

安装为 Agent 技能

部分 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 版本（以及其他通过通用 CallMcpTool 封装 MCP 工具的客户端）可能会显示不完整的工具架构，其中缺少 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 技能会为客户端 AI Agent 提供额外的上下文和说明，帮助其正确使用此 MCP 服务，包括：

• 推荐的工具调用流程（create_account -> create_project -> create-code-vault -> 轮询）
• 首次分析与重新分析的完成规则（快照报告与对比报告）
• 重试/退避行为以及 LOCAL_AGENT 后续操作指南

这是什么？

这是一个托管式 MCP 服务，可让 AI Agent 在不中断对话的情况下创建账户、管理项目、分析代码并获取分析结果。它面向需要快速、可靠的代码洞察和清晰报告的企业领导者（并购从业者、CTO、风投人士、董事会成员）。

任何代码库都可以进行分析，具体取决于代码量，最快 30 分钟即可获得结果。分析完成后，系统会自动通过电子邮件向用户发送包含结果的 PDF 报告；作为用户的 AI Agent，你可以在结果就绪后立即获取，以便在与用户的对话中展示，或据此生成图表、报告等。

什么是 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。

功能

• 零配置：Agent 可自动创建账户，你只需要提供其电子邮件地址、姓名和团队／公司名称
• 隐私优先：使用 LOCAL_AGENT 代码源类型可让代码保留在你的机器上，并且只会发送包含结果的匿名 zip 文件
• 按套餐提供分析：免费账户可以同步代码并获取摘要级别的结果；付费套餐可解锁完整的发现数据和高级输出
• 面向管理层的报告：PDF 报告会自动通过电子邮件发送给用户，可直接提供给非技术相关方
• 多种来源：本地代码仓库或文件夹、GIT 仓库或文件存档

面向 AI Agent 或系统的示例提示词

配置好 MCP 服务后，你可以向 AI Agent 或系统提出以下问题：

• “使用 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": "[email protected]",
      "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 只会返回新版本的数据。无法再通过这些工具访问之前版本的数据。

使用场景

并购尽职调查

快速评估收购目标的技术风险、安全漏洞和架构问题。参见 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 集成
• 自定义 Agent - 构建你自己的 MCP 客户端

Agent 技能（可选）

此代码仓库包含一项可复用的 Agent 技能，位于 skills/code-registry，可为 Agent 提供有关此 MCP 服务的更多背景信息和具体操作说明（工具调用顺序、轮询生命周期、完成规则和结果解读）。

• 技能入口：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 文件夹安装到 Agent 的技能目录中，然后正常运行 Agent：

• Codex：$CODEX_HOME/skills/
• Claude Code：~/.claude/skills/
• Cursor 项目本地目录：.cursor/skills/

使用详情和脚本示例，请参阅 skills/README.md。

定价

• 免费套餐：最多支持 100,000 行代码。包含账户创建、项目和代码库管理、代码同步以及摘要级 MCP 输出。
• 付费套餐：解锁完整分析数据和高级功能，例如验证徽章、公开验证页面、Code Score（满分 1,000）及其他高级功能。付费套餐还可使用完整数据 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 Agent 技能

为什么使用 The Code Registry MCP 服务？

面向并购专业人士：

• 快速开展技术尽职调查（数小时，而非数周）
• 无需人工代码审查
• 适合管理层阅读的 PDF 报告
• 客观评估技术风险

面向 CTO 和技术负责人：

• 监控整个投资组合中的技术债务
• 跟踪安全漏洞
• 了解代码库的复杂性
• 基于数据做出技术决策

面向风险投资人和董事会成员：

• 评估投资组合公司的技术风险
• 长期跟踪工程指标
• 获取客观的技术洞察
• 为投资组合公司的 CTO 提供支持

支持

• 电子邮件：[email protected]
• 问题反馈：使用 GitHub Issues 提交错误报告和功能请求
• 网站：thecoderegistry.com

许可证

详情请参阅 LICENSE 文件。

贡献

欢迎参与贡献！请参阅 CONTRIBUTING.md 了解相关指南。

---