MCP PR Review

An MCP (Model Context Protocol) server for automatic code review using OpenRouter as the LLM provider.

🚀 Features

• Intelligent code review: Analyzes your code and suggests improvements based on:

  • Performance optimizations

  • Clean Code principles

  • SOLID principles application

  • Proper async handling

  • Error handling

  • Security best practices

• Multiple LLM support: Uses OpenRouter to access different models

• Direct file modification: Inserts JSDoc review comments directly into your files

• Easy integration: Connects with any MCP-compatible client

Related MCP server: Claude Code Review MCP

📋 Requirements

• Node.js >= 18.0.0

• Yarn 4

• OpenRouter API Key

🛠️ Installation

1. Clone the repository

git clone <your-repo>
cd mcp-pr-review

2. Install dependencies:

yarn install

3. Configure environment variables:

cp .env.example .env

Edit the .env file and add your OpenRouter API key:

OPENROUTER_API_KEY=your_api_key_here
OPENROUTER_MODEL=moonshotai/kimi-k2:free

🔑 Getting OpenRouter API Key

1. Go to OpenRouter

2. Create an account

3. Generate an API key in your dashboard

4. Add it to your .env file

🚀 Usage

Running the server

# Production mode
yarn start

# Development mode (with watch)
yarn dev

Using MPC client

Add this configuration to your MCP configuration file:

{
  "mcpServers": {
    "code-review": {
      "command": "node",
      "args": ["path/to/mcp-pr-review/src/index.js"],
      "env": {
        "OPENROUTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

review

Reviews a code file and inserts JSDoc review comments directly into the file.

Parameters:

• file_path (string): Absolute path to the file you want to review

Important notes:

• ⚠️ Only absolute paths are accepted (paths starting with /)

• 📝 The tool modifies the original file by inserting JSDoc comments

• 🔍 Review categories include: SOLID, PERFORMANCE, ASYNC, ERROR_HANDLING, CLEAN_CODE, SECURITY

Example usage:

# In your MCP client (like Claude Desktop)
/review /Users/username/project/src/myfile.js

What the tool does:

1. Reads the specified file

2. Analyzes the code for issues

3. Generates JSDoc comments with @fixme annotations

4. Inserts these comments directly into the file before problematic lines

5. Saves the modified file

Example output format:

/**
 * @fixme PERFORMANCE: Consider using more efficient algorithm
 * @example Use Map instead of nested loops for O(1) lookups
 */
function inefficientFunction() {
  // your code here
}

🔧 Configuration

Environment Variables

Recommended Models

• Free models:

  • moonshotai/kimi-k2:free

  • meta-llama/llama-3.1-8b-instruct:free

  • google/gemini-flash-1.5

• Paid models (better quality):

  • anthropic/claude-3-haiku:beta

  • microsoft/wizardlm-2-8x22b

  • anthropic/claude-3-sonnet:beta

🧪 Development

Project Structure

mcp-pr-review/
├── src/
│   └── index.js          # Main MCP server
├── package.json          # Dependencies and scripts
├── .env.example         # Environment variables template
├── .gitignore           # Files to ignore by git
└── README.md            # This documentation

Available Scripts

yarn start     # Run in production
yarn dev       # Run in development mode
yarn test      # Run tests (not implemented yet)