Claude Code Review

@vibesnipe/code-review-mcp

Version: 1.0.0

An MCP (Model Context Protocol) server that provides a powerful tool to perform code reviews using various Large Language Models (LLMs). This server is designed to be seamlessly integrated with AI coding assistants like Anthropic's Claude Code, Cursor, Windsurf, or other MCP-compatible clients.

Note: This tool was initially created for Claude Code but has since been expanded to support other AI IDEs and Claude Desktop. See the integration guides for Claude Code, Cursor, and Windsurf.

It analyzes git diff output for staged changes, differences from HEAD, or differences between branches, providing contextualized reviews based on your task description and project details.

Features

• Reviews git diffs (staged changes, current HEAD, branch differences).
• Integrates with Google Gemini, OpenAI, and Anthropic models through the Vercel AI SDK.
• Allows specification of task description, review focus, and overall project context for tailored reviews.
• Outputs reviews in clear, actionable markdown format.
• Designed to be run from the root of any Git repository you wish to analyze.
• Easily installable and runnable via npx for immediate use.

Compatibility

• Node.js: Version 18 or higher is required.
• Operating Systems: Works on Windows, macOS, and Linux.
• Git: Version 2.20.0 or higher recommended.

Prerequisites

• Node.js: Version 18 or higher is required.
• Git: Must be installed and accessible in your system's PATH. The server executes git commands.
• API Keys for LLMs: You need API keys for the LLM providers you intend to use. These should be set as environment variables:
  • GOOGLE_API_KEY for Google models.
  • OPENAI_API_KEY for OpenAI models.
  • ANTHROPIC_API_KEY for Anthropic models. These can be set globally in your environment or, conveniently, in a .env file placed in the root of the project you are currently reviewing. The server will automatically try to load it.

Installation & Usage

The primary way to use this server is with npx, which ensures you're always using the latest version without needing a global installation.

Recommended: Using with npx

1. Navigate to Your Project: Open your terminal and change to the root directory of the Git repository you want to review.

   cd /path/to/your-git-project
   

2. Run the MCP Server: Execute the following command:

   npx -y @vibesnipe/code-review-mcp
   

   This command will download (if not already cached) and run the @vibesnipe/code-review-mcp server. You should see output in your terminal similar to: [MCP Server] Code Reviewer MCP Server is running via stdio and connected to transport. The server is now running and waiting for an MCP client (like Claude Code, Cursor, or Windsurf) to connect.

Installing via Smithery

To install code-review-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @praneybehl/code-review-mcp --client claude

Integration with Claude Code

Once the claude-code-review-mcp server is running (ideally via npx from your project's root):

1. Add as an MCP Server in Claude Code: In a separate terminal where Claude Code is running (or will be run), configure it to use this MCP server. The command to run the server (as used by Claude Code) would be code-review-mcp if installed globally and in PATH, or the npx ... command if you prefer Claude Code to always fetch it.

   To add it to Claude Code:

   claude mcp add code-reviewer -s <user|local> -e GOOGLE_API_KEY="key" -- code-review-mcp 
   

   If you want Claude Code to use npx (which is a good practice to ensure version consistency if you don't install globally):

   claude mcp add code-reviewer -s <user|local> -e GOOGLE_API_KEY="key" -- npx -y @vibesnipe/code-review-mcp
   

   This tells Claude Code how to launch the MCP server when the "code-reviewer" toolset is requested. This configuration can be project-specific (saved in .claude/.mcp.json in your project) or user-specific (global Claude Code settings).

2. Use Smart Slash Commands in Claude Code: Create custom slash command files in your project's .claude/commands/ directory to easily invoke the review tool. The package includes several example commands in the examples/claude-commands/ directory that you can copy to your project.

   These improved slash commands don't require you to manually specify task descriptions or project context - they leverage Claude Code's existing knowledge of your project and the current task you're working on.

   Example invocation using a slash command in Claude Code:

   claude > /project:review-staged-claude
   

   No additional arguments needed! Claude will understand what you're currently working on and use that as context for the review.

   For commands that require arguments (like review-branch-custom-gemini.md which uses a custom branch name), you can pass them directly after the command:

   claude > /project:review-branch-custom-gemini main
   

   This will pass "main" as the $ARGUMENTS_BASE_BRANCH parameter.

Integration with Modern AI IDEs

Cursor Integration

Cursor is a popular AI-powered IDE based on VS Code that supports MCP servers. Here's how to integrate the code review MCP server with Cursor:

1. Configure Cursor's Rules for Code Review:

   Create or open the .cursor/rules/project.mdc file in your project and add the following section:

   ## Slash Commands
   
   /review-staged: Use the perform_code_review tool from the code-reviewer MCP server to review staged changes. Use anthropic provider with claude-3-7-sonnet-20250219 model. Base the task description on our current conversation context and focus on code quality and best practices.
   
   /review-head: Use the perform_code_review tool from the code-reviewer MCP server to review all uncommitted changes (HEAD). Use openai provider with o3 model. Base the task description on our current conversation context and focus on code quality and best practices.
   
   /review-security: Use the perform_code_review tool from the code-reviewer MCP server to review staged changes. Use anthropic provider with claude-3-5-sonnet-20241022 model. Base the task description on our current conversation context and specifically focus on security vulnerabilities, input validation, and secure coding practices.
   

2. Add the MCP Server in Cursor:

   • Open Cursor settings
   • Navigate to the MCP Servers section
   • Add a new MCP server with the following JSON configuration:

   "code-reviewer": {
     "command": "npx",
     "args": ["-y", "@vibesnipe/code-review-mcp"],
     "env": {
       "GOOGLE_API_KEY": "your-google-api-key",
       "OPENAI_API_KEY": "your-openai-api-key",
       "ANTHROPIC_API_KEY": "your-anthropic-api-key"
     }
   }
   

3. Using the Commands:

   In Cursor's AI chat interface, you can now simply type:

   /review-staged
   

   And Cursor will use the claude-code-review-mcp server to perform a code review of your staged changes.

Windsurf Integration

Windsurf (formerly Codeium) is another advanced AI IDE that supports custom workflows via slash commands. Here's how to integrate with Windsurf:

1. Configure the MCP Server in Windsurf:

   • Open Windsurf
   • Click on the Customizations icon in the top right of Cascade
   • Navigate to the MCP Servers panel
   • Add a new MCP server with the following JSON configuration:

   "code-reviewer": {
     "command": "npx",
     "args": ["-y", "@vibesnipe/code-review-mcp"],
     "env": {
       "GOOGLE_API_KEY": "your-google-api-key",
       "OPENAI_API_KEY": "your-openai-api-key",
       "ANTHROPIC_API_KEY": "your-anthropic-api-key"
     }
   }
   

2. Create Workflows for Code Review:

   Windsurf supports workflows that can be invoked via slash commands. Create a file in .windsurf/workflows/review-staged.md:

   # Review Staged Changes
   
   Perform a code review on the currently staged changes in the repository.
   
   ## Step 1
   
   Use the perform_code_review tool from the code-reviewer MCP server with the following parameters:
   

   { "target": "staged", "llmProvider": "anthropic", "modelName": "claude-3-7-sonnet-20250219", "taskDescription": "The task I am currently working on in this codebase", "reviewFocus": "General code quality, security best practices, and performance considerations", "projectContext": "This project is being developed in Windsurf. Please review the code carefully for any issues." }

   Similarly, create workflows for other review types as needed.

3. Using the Workflows:

   In Windsurf's Cascade interface, you can invoke these workflows with:

   /review-staged
   

   Windsurf will then execute the workflow, which will use the claude-code-review-mcp server to perform the code review.

Tool Provided by this MCP Server

perform_code_review

Description: Performs a code review using a specified Large Language Model on git changes within the current Git repository. This tool must be run from the root directory of the repository being reviewed.

Input Schema (Parameters):

The tool expects parameters matching the CodeReviewToolParamsSchema:

• target (enum: 'staged', 'HEAD', 'branch_diff'): Specifies the set of changes to review.
  • 'staged': Reviews only the changes currently staged for commit.
  • 'HEAD': Reviews uncommitted changes (both staged and unstaged) against the last commit.
  • 'branch_diff': Reviews

---

README truncated. View full README on GitHub.