Crazyrabbitltc MCP Code Review Server

🚀 代碼審查服務器

代碼審查服務器是一個自定義的MCP服務器，它藉助Repomix和大語言模型（LLMs）開展代碼審查工作。該服務器能夠對代碼庫進行扁平化處理，利用多種大語言模型分析代碼，並輸出結構化的代碼評論，為開發者提供具體問題和改進建議。

🚀 快速開始

代碼審查服務器的使用較為便捷，你可以按照以下步驟進行操作：

1. 完成服務器的安裝和配置。
2. 啟動服務器並選擇合適的工具開展代碼審查。

✨ 主要特性

• 代碼庫扁平化：使用Repomix將代碼庫進行扁平化處理。
• 多模型分析：運用大型語言模型對代碼進行分析。
• 結構化評論：獲取包含具體問題和建議的結構化代碼評論。
• 多供應商支持：支持多個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服務器

代碼審查服務器實現模型上下文協議（MCP），可以與任何MCP客戶端一起使用：

# 啟動服務器
node build/index.js

服務器提供兩個主要工具：

1. analyze_repo：使用Repomix扁平化代碼庫。
2. code_review：使用LLM執行代碼審查。

何時使用MCP工具

此服務器針對不同的代碼分析需求提供了兩種不同的工具：

analyze_repo

使用此工具當你需要：

• 獲取代碼庫的高階概述和結構。
• 使用Repomix扁平化代碼庫以進行初始分析。
• 理解目錄結構和文件內容而無需詳細審查。
• 為更深入的代碼審查做準備。
• 快速掃描代碼。

例如：

# 示例命令
node analyze_repo --path /your/repository/path

code_review

使用此工具當你需要：

• 深入分析代碼並獲取詳細的審查結果。
• 處理大代碼庫的分塊。
• 根據焦點領域和詳細程度生成詳細的審查報告。

LLM 集成工作原理

1. code_review工具使用Repomix處理代碼以扁平化倉庫結構。
2. 代碼經過格式化並進行分塊（如果需要）以適應LLM上下文限制。
3. 根據焦點領域和詳細程度生成詳細的提示。
4. 提示和代碼直接發送到你選擇的LLM供應商的API。
5. LLM響應被解析為結構化的格式。
6. 審查結果作為JSON對象返回，包含問題、優勢和建議。

實現包括重試邏輯以增強對API錯誤的彈性，並且確保代碼格式正確以便將最相關的代碼包含在審查中。

代碼審查輸出格式

代碼審查以結構化JSON格式返回：

{
  "summary": "代碼及其目的的簡要概述",
  "issues": [
    {
      "type": "SECURITY|PERFORMANCE|QUALITY|MAINTAINABILITY",
      "severity": "HIGH|MEDIUM|LOW",
      "description": "問題描述",
      "line_numbers": [12, 15],
      "recommendation": "推薦修復方法"
    }
  ],
  "strengths": ["代碼優勢列表"],
  "recommendations": ["總體建議列表"]
}

📄 許可證

本項目採用MIT許可證。