MCP Server Code Review

🚀 MCP Server - Code Review

A server implementation for the Model Context Protocol (MCP) that connects Cursor to the OpenRouter API via stdio, offering code review and AI chat capabilities.

✨ Features

• Connect to the OpenRouter API to access a variety of large language models.
• Provide two core functions:
  • Simple text prompt response (ask tool).
  • Automated code review with project context analysis (code_review tool).
• Integrate repomix for codebase packaging and analysis.
• Support automatic detection of projects in multiple programming languages.
• Operate as an stdio server compliant with the MCP protocol.

📦 Installation

# Global installation
npm install -g mcp-server-code-review

# Or local installation in the project
npm install mcp-server-code-review

Configuration Requirements

• Node.js v16 or higher.
• OpenRouter API key - Obtain it from OpenRouter.

💻 Usage Examples

Command-line Options

mcp-server-code-review --api-key YOUR_OPENROUTER_API_KEY [--default-model MODEL_ID]

Parameter Explanation

• --api-key, -k (Required): Your OpenRouter API key.
• --default-model, -m (Optional): The default model ID to use (default is google/gemini-2.0-flash-thinking-exp:free).

Example Usage

mcp-server-code-review --api-key sk-or-v1-xxxxxxxxxxxx --default-model anthropic/claude-3-haiku:free

📚 Documentation

MCP Tools Explanation

This server implements two main MCP tools:

1. Ask Tool

Send simple text prompts to the OpenRouter API and return responses.

"mcp-openrouter-stdio": {
      "name": "mcp-openrouter-stdio",
      "command": "npx",
      "args": [
        "mcp-openrouter-stdio",
        "--api-key",
        "sk-or-v1-your_key",
        "--default-model",
        "google/gemini-2.0-flash-thinking-exp:free"
      ],
      "transport": "stdio"
    },

2. Code Review Tool

Conduct code reviews using the OpenRouter API with project context analysis.

{
  name: "code_review",
  arguments: {
    completed_tasks: ["Task 1", "Task 2"],
    work_report: "Details of the work performed",
    project_path: "/absolute/path/to/project",
    planned_tasks: ["Future Task 1", "Future Task 2"],
    language: "js", // The main programming language of the project
    model: "optional-model-id" // Use the default model if not specified
  }
}

Supported Languages

This server supports automatic detection and analysis of projects in multiple programming languages:

• JavaScript/TypeScript (js)
• Python (python)
• C# (csharp)
• PHP (php)
• Java (java)
• Ruby (ruby)
• Go (go)
• Rust (rust)
• C++ (cpp)
• Swift (swift)

Development Steps

# Clone the repository
git clone https://github.com/arahisman/mcp-server-code-review.git
cd mcp-server-code-review

# Install dependencies
npm install

# Build the project
npm run build

# Enable development mode
npm run watch

Test Scripts

The repository contains multiple test scripts:

# Basic server test
node test-mcp-server.js

# Test the ask tool
node test-ask.js

# Simple functionality test
node simple-test.js

📄 License

MIT

Author

Adam Rahisman