Skip to main content
Glama

Review MCP Server

by je4550
GitHub
JavaScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Review MCP Server

Get a second opinion on your code! This MCP server integrates Codex and Gemini CLIs into Claude Code for thorough, senior-level code reviews.

Quick Start

1. Install

git clone https://github.com/je4550/review-mcp.git cd review-mcp npm install npm run build

2. Configure Claude Code

Add to ~/.config/claude-code/mcp.json:

{ "mcpServers": { "review-mcp": { "command": "node", "args": ["/absolute/path/to/review-mcp/dist/index.js"] } } }

Important: Replace /absolute/path/to with your actual installation path.

3. Set Up CLI Tools (Optional)

The server works with whichever CLIs you have installed:

For Codex reviews (via OpenAI):

# If you have codex-cli (recommended): codex --version # Should show codex-cli version # OR install OpenAI CLI: npm install -g openai export OPENAI_API_KEY="sk-..."

For Gemini reviews:

npm install -g @google/gemini-cli export GOOGLE_API_KEY="..."

Or use the setup script: ./setup-gemini.sh

4. Restart Claude Code

That's it! The server will automatically detect which CLIs are available.

How to Use

Just ask Claude naturally:

You: "Review this authentication function" You: "Get a second opinion on this code" You: "Check src/auth.ts for security issues" You: "Review all files in the api/ directory"

Claude will:

  1. Send your code to available reviewers (Codex/Gemini)

  2. Collect their feedback

  3. Add its own analysis

  4. Present you with multiple expert perspectives

Available Tools

The server provides four MCP tools Claude can use:

Tool

Description

Example

check_cli_status

Check which CLIs are available

"What review CLIs do I have?"

review_code

Review a code snippet

"Review this function: [code]"

review_file

Review a specific file

"Review src/index.ts"

review_directory

Review all code in a directory

"Review the entire src/ folder"

You don't need to remember these - just ask Claude naturally!

What You Get

Senior-Level Reviews

The server sends a comprehensive prompt asking reviewers to act as senior engineers and check:

  • Code Quality - readability, maintainability, best practices

  • Bugs & Edge Cases - logic errors, error handling gaps

  • Security - vulnerabilities, input validation, auth issues

  • Performance - inefficiencies, memory leaks, scalability

  • Recommendations - prioritized by severity (Critical/High/Medium/Low)

See PROMPT.md for the exact prompt.

Example Review

Your code:

function auth(user, pass) { return user === "admin" && pass === "12345"; }

Codex feedback:

Hard-coding credentials is an immediate security risk—anyone with source access can log in, and the password cannot be rotated without redeploying. There is no account locking, auditing, or rate limiting, so brute force attempts go unnoticed. This should be replaced with a secure authentication mechanism that validates credentials against hashed values in a datastore...

Claude's synthesis:

I agree with Codex's assessment. This is a critical security vulnerability. Additionally, I notice... [Claude's insights]

Features

✅ Auto-Detection - Finds available CLIs on startup (no failed attempts) ✅ Senior-Level Prompts - Gets thorough, professional feedback ✅ Review Validation - Automatically validates and filters invalid/unhelpful responses ✅ Parallel Execution - Reviews run simultaneously when both CLIs available ✅ Smart Fallbacks - Works with one or both reviewers ✅ Generous Timeouts - 5 minutes per review for complex code ✅ Multiple Review Modes - Snippets, files, or entire directories

Supported Languages

Automatically detects and reviews: .js .ts .jsx .tsx .py .rb .go .java .c .cpp .cs .php .swift .kt .rs

Troubleshooting

"No review CLIs available"

Run in Claude Code: "Check CLI status"

This shows which CLIs are installed. Install at least one:

  • Codex: codex --version (if you have codex-cli)

  • Gemini: npm install -g @google/gemini-cli

Reviews timing out

The server allows 5 minutes per review. If still timing out:

  • Check internet connection

  • Verify API keys are valid

  • Try reviewing smaller chunks of code

API Keys not working

Make sure keys are set in your environment:

echo $OPENAI_API_KEY # Should show your key echo $GOOGLE_API_KEY # Should show your key

Add to your ~/.bashrc or ~/.zshrc to persist:

export OPENAI_API_KEY="sk-..." export GOOGLE_API_KEY="..."

More Documentation

Development

Watch mode for live rebuilding:

npm run watch

How It Works

┌─────────────┐ │ You write │ │ code │ └──────┬──────┘ │ ├──────────────────────────────┐ │ │ ▼ ▼ ┌─────────────┐ ┌──────────────┐ │ Claude │──requests──▶ │ Review MCP │ │ Code │ review │ Server │ └─────────────┘ └──────┬───────┘ ▲ │ │ ├─────────┬─────────┐ │ ▼ ▼ ▼ │ ┌──────────┐ ┌──────┐ ┌──────┐ │ │ Detects │ │Codex │ │Gemini│ │ │ CLIs │ │ CLI │ │ CLI │ │ └──────────┘ └───┬──┘ └──┬───┘ │ │ │ │ ▼ ▼ │ ┌────────────────┐ │ │ Senior-level │ │ │ code reviews │ │ │ (5 min each) │ │ └────────┬───────┘ │ │ └───────────────────────────────────────────┘ Claude adds its analysis and presents all feedback

License

MIT

Contributing

Issues and PRs welcome at https://github.com/je4550/review-mcp

Deploy Server
-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

Enables Claude to perform thorough code reviews by integrating with Codex and Gemini CLIs to provide senior-level feedback on code quality, security, performance, and best practices. Supports reviewing code snippets, individual files, or entire directories with automatic detection of available review tools.

  1. Quick Start
    1. 1. Install
    2. 2. Configure Claude Code
    3. 3. Set Up CLI Tools (Optional)
    4. 4. Restart Claude Code
  2. How to Use
    1. Available Tools
      1. What You Get
        1. Senior-Level Reviews
        2. Example Review
      2. Features
        1. Supported Languages
          1. Troubleshooting
            1. "No review CLIs available"
            2. Reviews timing out
            3. API Keys not working
          2. More Documentation
            1. Development
              1. How It Works
                1. License
                  1. Contributing

                    New MCP Servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/je4550/review-mcp'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server