代码智能分析服务

为企业级用户提供AI驱动的代码库智能分析服务,支持技术债务评估、安全漏洞检测和代码质量分析等功能。

  • by The-Code-Registry
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 The-Code-Registry/mcp-server

使用说明

代码注册表MCP服务器

Enterprise-grade code intelligence for AI assistants

Quick Start • Features • Use Cases • Documentation • Website


code Registry为商业领袖提供企业级代码智能。现在,我们为AI代理提供了一个功能齐全的原生MCP服务器。直接从Claude Desktop、Claude API和其他兼容MCP的客户分析尽职调查、技术债务、安全漏洞、代码质量等方面的代码库。

作为MCP服务器安装

配置任何MCP兼容客户端时使用此URL:

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

安装为代理技能

一些MCP客户端和编辑器(包括Cursor)在技能使用工具之前需要配置MCP服务器。

游标MCP服务器配置(示例)

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

在游标MCP设置中使用此JSON,或从以下位置复制相同的示例 integrations/cursor/config.json.

光标/ CallMcpTool 已知的限制和解决方法

一些Cursor构建(以及其他将MCP工具封装在通用框架后面的客户端 CallMcpTool)可能会显示省略的不完整工具架构 arguments,即使运行时接受它。

对于代码注册表工具,始终在 arguments 使用时的字段 CallMcpTool.

经常修复此行为的提示:

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代理提供了正确使用此MCP服务器的额外上下文和说明,包括:

  • 推荐的工具流程(create_account -> create_project -> create-code-vault ->投票)
  • 首次分析与重新分析的完成规则(快照与比较报告)
  • 重试/回退行为和LOCAL_AGENT后续指导

这是什么?

这是一个托管的MCP服务器,允许AI代理创建帐户、管理项目、分析代码和检索分析结果,而无需离开对话。它专为需要快速、可靠的代码见解和干净报告的商业领袖(并购专业人士、CTO、VC、董事会成员)而设计。

任何代码库都可以被分析,结果可以在30分钟内准备好,具体取决于代码量。分析完成后,包含结果的PDF报告会自动通过电子邮件发送给用户,作为他们的AI代理,您可以在结果准备就绪后立即检索结果,以便在与用户的对话中显示或生成图表/报告等。

什么是MCP?

模型上下文协议(MCP)是一个开放标准,使AI助手能够安全地连接到数据源和工具。了解更多信息,请访问 模型上下文协议.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_AAGENT:您的计算机上已安装Docker
  • 对于GIT源:具有适当访问权限的GIT存储库URL
  • 对代码分析和软件度量的基本理解

现有账户

如果用户已经拥有代码注册帐户,他们可以在web应用程序中生成API密钥,并通过 X-API-Key 标题(首选)。如果MCP客户端无法设置自定义标头,请传递 api_key 相反,在工具论证中。

特征

  • 零设置:代理可以自动创建帐户,您只需要他们的电子邮件地址、姓名和团队/公司名称
  • 隐私第一:使用LOCAL_AAGENT代码源类型可以将代码保存在您的计算机上,并且只发送一个匿名的结果zip文件
  • 计划意识分析:免费帐户可以同步代码并检索摘要级结果;付费计划解锁完整的调查结果数据和高级输出
  • 高管友好型报告:PDF报告会自动通过电子邮件发送给用户,供非技术利益相关者使用
  • 多种来源:本地代码仓库或文件夹、GIT仓库或文件档案

AI代理或系统的示例提示

配置完MCP服务器后,您可以向AI代理或系统提出以下问题:

  • “使用代码注册表分析此代码库,并以一种很好的方式呈现结果。”
  • “使用代码注册表重新分析此项目的代码,向我展示自上次分析以来发生了什么变化。”
  • “从我的代码注册帐户获取项目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_AAGENT)

{
  "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
  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/ 对于特定于客户端的设置:

  • 克劳德桌面 -桌面应用程序配置
  • API克劳德 -API与Python/TypeScript示例的集成
  • 克莱恩 -VS代码扩展设置
  • 光标 -游标IDE集成
  • 自定义代理 -构建自己的MCP客户端

代理技能(可选)

此存储库包括可重用的代理技能 skills/code-registry 这为代理提供了此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 将文件夹放入代理的技能目录,然后正常运行代理:

  • 食品法典: $CODEX_HOME/skills/
  • 克劳德代码: ~/.claude/skills/
  • 游标项目本地: .cursor/skills/

看 skills/README.md 了解用法细节和脚本示例。

定价

  • 免费层:最多100000行代码。包括帐户创建、项目/保管库管理、代码同步和摘要级MCP输出。
  • 付费计划:解锁完整的分析数据和高级功能,如验证徽章、公共验证页面、代码得分(满分1000)和其他高级功能。付费计划还支持完整的数据MCP工具: get-security-issues, get-code-smells, get-git-history, get-contributors, get-components, get-code-iq-automated-queries,以及 get-the-code-score仅验证(VerifyYourCode)计划不包括访问这些工具。
  • 企业:联系我们 thecollegistery.com 用于定制定价和批量折扣。

适用于所有计划:

  • 账户和API密钥管理
  • 项目和代码库生命周期工具
  • LOCAL_AGENT、GIT和FILE_ARCIVE摄入

文档

  • 入门: docs/getting-started.md -逐步演练
  • api参考: docs/api-reference.md -完整的行动参考
  • 认证: docs/authentication.md -API密钥管理
  • Facets术语表: docs/facets.md -结果中分析方面的定义
  • 故障排除: docs/troubleshooting.md -常见问题和解决方案
  • 建筑: docs/architecture.md -系统设计概述
  • 技能指南: skills/README.md -安装和使用代码注册表代理技能

为什么使用代码注册表MCP服务器?

对于并购专业人士:

  • 快速技术尽职调查(数小时,而非数周)
  • 无需手动代码审查
  • 易于执行的PDF报告
  • 客观的技术风险评估

对于CTO和技术负责人:

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

对于风险投资公司和董事会成员:

  • 评估投资组合公司的技术风险
  • 随时间跟踪工程指标
  • 获得客观的技术见解
  • 支持投资组合公司的首席技术官

支持

  • 电子邮件: support@thecoderegistry.com
  • 问题:使用GitHub Issues进行错误报告和功能请求
  • 网站: thecollegistery.com

许可证

看 许可证 文件以获取详细信息。

贡献

我们欢迎捐款!看 贡献.md 作为指导方针。


Built with ❤️ by The Code Registry

The World's first code intelligence platform built for business leaders