使用说明
代码注册表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流,包括:
initializetools/listtools/callresources/list和resources/readprompts/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报告在分析完成后生成,并自动通过电子邮件发送给用户。
重新分析现有代码库
要对现有代码库重新运行分析,请执行以下操作:
- 呼叫
reanalyze-code-vault - 如果原始源类型为
LOCAL_AGENT - 像往常一样轮询相同的摘要/结果/报告工具
重要提示: 一旦重新分析开始, 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