代码审查助手

代码审查MCP服务器（第5阶段）

该存储库现在只专注于第5阶段：交付一个模型上下文协议服务器，为VS code中的实用代码审查助手提供动力。早期阶段的实验已经退役；剩下的代码和文档是为了支持这个单一目标而存在的。

当前目标

• 通过分析git差异、静态信号和项目元数据，为阶段性变更提供结构化的审查指导。
• 通过MCP兼容客户端直接在VS Code中显示可操作的发现。
• 提供可重复的工作流程（检查表、回归风险、测试差距），以补充人工审阅者，而不是取代他们。

活动工作流

• 基础： 加固TypeScript MCP服务器并扩展工具注册表（附带了code-review.collect-context）。
• 数据摄取： 从编辑器和git收集文件差异、元数据和repo上下文。
• 分析启发式： 为常见的审查气味（缺失测试、风险依赖关系变化、不安全模式）构建检测器。
• 反馈表面： 将响应格式化为结构化注释，清晰地映射到VS代码面板或内联注释。

地方发展

npm install   # one-time dependency restore
npm run build # compile TypeScript to dist/
npm start     # launch the MCP server over stdio

在VS Code内部运行时，通过您首选的MCP客户端（例如官方扩展或Bruno桥）连接服务器，并通过stdio流式传输JSON-RPC消息。

可用工具

• code-review.collect-context --返回存储库根、分支分歧、分阶段/非分阶段分解以及可选的最近提交，以种子下游审查启发式方法。
• code-review.diff-insights --总结了阶段性或工作树差异，包括流失指标、重命名跟踪和可选补丁摘录。
• code-review.run-heuristics --对重大更改、缺失测试、配置编辑和其他审查提示的差异进行评分，返回结构化结果和下一步建议。

仓库的规划

• src/index.ts –第5阶段MCP服务器入口点（工具将逐步添加）。
• dist/ –编译的JavaScript输出由生成 npm run build.
• MCP_LEARNING_GAMEPLAN.md –提供第5阶段代码审查助手的详细路线图。