mcp-dev-review

An MCP (Model Context Protocol) server that uses Google Gemini to perform AI-powered code reviews on your latest git changes. Works inside Cursor and VS Code — no cloning or building needed.

Prerequisites

• Node.js >= 18
• A Google Gemini API key — get one free at Google AI Studio

Quick Setup

Cursor

Add this to .cursor/mcp.json in your project (or your global Cursor settings):

{
    "mcpServers": {
        "dev-review": {
            "command": "npx",
            "args": ["-y", "mcp-dev-review"],
            "env": {
                "GEMINI_API_KEY": "your-gemini-api-key-here"
            }
        }
    }
}

VS Code

Add this to .vscode/mcp.json:

{
    "servers": {
        "dev-review": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "mcp-dev-review"],
            "env": {
                "GEMINI_API_KEY": "your-gemini-api-key-here"
            }
        }
    }
}

That's it. The package is fetched automatically by npx on first use.

Usage

Once connected, just ask your AI assistant to review your code:

• "Review my latest code changes"
• "Review the diff against main"
• "Review my code with a focus on security"

review_code tool

| Parameter | Required | Description | | ------------ | -------- | -------------------------------------------------------------------------------------------- | | baseBranch | No | Branch or ref to diff against (e.g. "main", "HEAD~3"). If omitted, auto-detects changes. | | focus | No | Focus area for the review: "security", "performance", "best practices", "bugs", etc. |

Change detection order (when baseBranch is omitted):

1. Staged changes (git diff --cached)
2. Unstaged changes (git diff)
3. Last commit (git diff HEAD~1 HEAD)

Review output includes:

• Summary of changes
• Issues found with severity (Critical / Warning / Info) and fix suggestions
• Improvement suggestions
• Security concerns
• Overall merge-readiness assessment

Publish to npm

npm login
npm publish

Development

cd mcpdevreview
npm install
npm run build

# Run locally
GEMINI_API_KEY=your-key node dist/index.js

License

MIT