The-Code-Registry/mcp-server

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" } } } ``` 在您的 Cursor MCP 设置中使用此 JSON，或从 `integrations/cursor/config.json` 复制相同的示例。 ### Cursor / `CallMcpTool` 已知限制和解决方案 某些 Cursor 构建（以及其他在通用 `CallMcpTool` 后包装 MCP 工具的客户端）可能显示不完整的工具模式，省略了 `arguments`，即使运行时接受它。 对于 The Code Registry 工具，始终在 `CallMcpTool` 中使用 `arguments` 字段传递所需参数。 提示信息通常可以解决这个问题： `使用具有参数字段的 CallMcpTool 传递所需参数。` 示例包装调用形状： ``` { "server": "coderegistry", "toolName": "create_project", "arguments": { "user_id": "", "name": "My Project" } } ``` 然后安装技能： ``` npx skills add The-Code-Registry/mcp-server ``` `code-registry` 技能为您客户端 AI 代理提供额外的上下文和使用此 MCP 服务器正确操作的说明，包括： - 推荐的工具流程（`create_account` -> `create_project` -> `create-code-vault` -> 轮询） - 首次分析 vs 重新分析（快照 vs 对比报告）的完成规则 - 重试/退避行为和 LOCAL_AGENT 后续指导 ## 这是什么？ 这是一个托管 MCP 服务器，允许 AI 代理创建账户、管理项目、分析代码并检索分析结果，而无需离开对话。它专为需要快速、可靠的代码见解和清晰报告的企业领导者（并购专业人士、CTO、风险投资家、董事会成员）设计。 任何代码库都可以进行分析，结果可以在 30 分钟内准备好，具体取决于代码量。分析完成后，包含结果的 PDF 报告将自动通过电子邮件发送给用户，作为您的 AI 代理，您可以在结果准备好后立即检索它们，以在您的用户对话中展示或生成图表/图表/报告等。 ## MCP 是什么？ 模型上下文协议（MCP）是一个开放标准，它使 AI 助手能够安全地连接到数据源和工具。更多信息请访问 [modelcontextprotocol.io](https://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`。 ## 功能 - **零配置**：代理可以自动创建账户，您只需要他们的电子邮件地址、姓名和团队/公司名称 - **以隐私为先**：使用 LOCAL_AGENT 代码源类型将代码保留在您的机器上，并且仅发送匿名 zip 文件的结果 - **计划感知分析**：免费账户可以同步代码并检索摘要级别结果；付费计划解锁完整发现数据和高级输出 - **适合高管报告**：PDF 报告将自动通过电子邮件发送给用户，供非技术利益相关者使用 - **多个来源**：本地代码库或文件夹、GIT 仓库或文件存档 ## 为您的 AI 代理或系统提供示例提示 配置 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": "", "name": "My Project", "description": "Optional" } }, "id": 3 } ``` ### 3) 创建代码保险库（推荐：LOCAL_AGENT） ``` { "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "create-code-vault", "arguments": { "project_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": "" } }, "id": 5 } ``` **注意**：结果通常在 30 分钟到几小时内准备好，具体取决于代码库大小。使用指数退避轮询。 ### 5) 获取报告 URL ``` { "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "get-code-vault-reports", "arguments": { "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 集成 - **自定义代理** - 构建您自己的 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：`$CODEX_HOME/skills/` - Claude Code：`~/.claude/skills/` - Cursor 项目本地：`.cursor/skills/` 有关使用说明和脚本示例，请参阅 `skills/README.md`。 ## 定价 - **免费层**：最多 100,000 行代码。包括账户创建、项目/保险库管理、代码同步和摘要级别 MCP 输出。 - **付费计划**：解锁完整分析数据和高级功能，例如验证徽章、公共验证页面、代码评分（满分 1,000）和其他高级功能。 - **企业**：请联系我们 [thecoderegistry.com](https://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 代理技能 ## 为什么使用 The Code Registry MCP 服务器？ **对于并购专业人士：** - 快速技术尽职调查（小时，而不是周） - 无需手动代码审查 - 适合高管 PDF 报告 - 客观的技術風險評估 **对于 CTO 和技术领导者：** - 监控投资组合中的技术债务 - 跟踪安全漏洞 - 理解代码库复杂性 - 基于数据的技術決策 **对于风险投资家和董事会成员：** - 评估投资组合公司的技术风险 - 跟踪工程指标随时间的变化 - 获取客观的技术见解 - 支持投资组合公司的 CTO ## 支持 - **电子邮件**：support@thecoderegistry.com - **问题**：使用 GitHub Issues 进行错误报告和功能请求 - **网站**：[thecoderegistry.com](https://thecoderegistry.com/） ## 许可证 有关详细信息，请参阅 [LICENSE](LICENSE) 文件。 ## 贡献 我们欢迎贡献！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。

由 The Code Registry 倾情打造

为商业领导者构建的世界上第一个代码智能平台

标签：AI 代理, AI 辅助, MCP 协议, MIT 许可, 代码分析, 代码分析工具, 代码安全, 代码库, 代码智能, 代码洞察, 代码质量评估, 企业应用, 企业级, 使用案例, 凭证管理, 功能特性, 安全漏洞, 开源协议, 快速入门, 技术债务, 技术支持, 技术栈分析, 文档, 日志审计, 服务器监控, 漏洞枚举, 网站, 请求拦截, 逆向工具