Mcp Code Review Server

Mcp Code Review Server

🚀 代码审查服务器

代码审查服务器是一个自定义的MCP服务器,它借助Repomix和大型语言模型(LLM)开展代码审查工作。通过该服务器,用户能够对代码库进行全面分析,获取结构化的审查结果,包含具体问题和改进建议。

✨ 主要特性

  • 代码库扁平化:使用Repomix将代码库进行扁平化处理。
  • 代码智能分析:利用大型语言模型对代码进行深入分析。
  • 结构化审查结果:获得包含具体问题和建议的结构化代码审查结果。
  • 多LLM供应商支持:支持多种LLM供应商,如OpenAI、Anthropic、Gemini。
  • 大代码库处理:具备处理大代码库分块的能力。

📦 安装指南

# 克隆仓库
git clone https://github.com/yourusername/code-review-server.git
cd code-review-server

# 安装依赖
npm install

# 构建服务器
npm run build

📚 详细文档

配置

基于.env.example模板创建根目录下的.env文件:

cp .env.example .env

编辑.env文件以设置首选的LLM供应商和API密钥:

# LLM 供应商配置
LLM_PROVIDER=OPEN_AI
OPENAI_API_KEY=your_openai_api_key_here

使用方法

作为MCP服务器

该代码审查服务器实现Model Context Protocol (MCP),可与任何MCP客户端一起使用:

# 启动服务器
node build/index.js

服务器提供两个主要工具:

  1. analyze_repo:使用Repomix扁平化代码库
  2. code_review:利用LLM执行代码审查

使用情况指南

analyze_repo

当需要以下功能时使用此工具:

  • 获取代码库的总体概览
  • 了解代码库的目的和结构
  • 分析代码库的主要组成部分

示例用法:

# 示例命令
node build/index.js analyze_repo --path /path/to/your/repo
code_review

当需要以下功能时使用此工具:

  • 深入分析代码质量
  • 识别潜在问题和漏洞
  • 获取改进建议

示例用法:

# 示例命令
node build/index.js code_review --path /path/to/your/repo --focus SECURITY,MAINTAINABILITY

LLM 集成细节

  1. 模型选择与配置
    • 默认使用供应商提供的特定版本,如OpenAI的gpt-4-turbo、Anthropic的claude-3-sonnet和Gemini的gemini-1.5-flash-preview
    • 允许用户通过环境变量覆盖默认模型选择。
  2. API 调用与错误处理
    • 实现了重试逻辑,增强API调用的稳定性。
    • 包括请求超时和错误处理机制,确保服务可靠性。
  3. 代码处理流程
    • 使用Repomix工具将代码库转换为线性文本,便于模型分析。
    • 根据上下文窗口限制对代码进行分块处理,确保模型能够有效处理。

代码审查输出格式

代码审查结果以结构化的JSON格式返回:

{
"summary": "代码库的简要总结和目的描述",
"issues": [
{
"type": "SECURITY|PERFORMANCE|QUALITY|MAINTAINABILITY",
"severity": "HIGH|MEDIUM|LOW",
"description": "问题的具体描述",
"line_numbers": [12, 15],
"recommendation": "建议的修复方案"
}
],
"strengths": ["代码库的优点列表"],
"recommendations": ["总体改进建议"]
}

📄 许可证

本项目采用MIT许可证。

  • 0 关注
  • 0 收藏,10 浏览
  • system 提出于 2025-09-30 11:06

相似服务问题