Ndlovu Code Reviewer

🚀 Code Review MCP Server

A Gemini-CLI powered code review assistant running as a Model Context Protocol (MCP) server, aiming to automate code review processes and provide intelligent insights.

🚀 Quick Start

This Code Review MCP Server is a Gemini-CLI powered assistant operating as a Model Context Protocol (MCP) server. It simplifies code review by automating mundane tasks and offering actionable insights.

✨ Features

• Automated Context Gathering: Automates the collection of diffs and lint results from local, uncommitted changes, saving time and effort.
• Hybrid Review Workflow: Runs a "hybrid" review that combines git diff output with linter findings, providing comprehensive analysis.
• Multi - Linter Support: Supports ESLint, JSHint, and TypeScript, ensuring wide - ranging coverage across different projects.
• Safe Gemini CLI Invocation: Safely calls the Gemini CLI, handling long prompts and timeouts to ensure stable operation.
• Structured JSON Output: Returns a structured JSON review, which can be easily integrated into MCP - compatible clients.

📦 Installation

Prerequisites

• Node.js 18 or later (ES modules and AbortSignals are used throughout).
• npm (installed with Node.js).
• Git (used to collect local diffs).
• Google Gemini CLI (gemini) installed and authenticated. See the Gemini quickstart for setup instructions.

Steps

git clone https://github.com/<your-org>/ndlovu-code-reviewer.git
cd ndlovu-code-reviewer
npm install
npm run build

If you plan to develop on the TypeScript source, you can skip npm run build and use the dev script.

💻 Usage Examples

Basic Usage

Start the MCP server

npm start

The server communicates via stdio and can be registered with MCP - compatible clients. After connection, call the review-local-changes tool to start the analysis.

Call the MCP tool

The review-local-changes tool analyzes local, uncommitted code changes.

Prerequisites:

• Uncommitted changes in your git repository.
• Changed files should be JavaScript, TypeScript, or Vue files (.js, .ts, .tsx, .vue).
• The Gemini CLI must be installed and authenticated.

Using the tool:

1. Automatically detects changes: Finds all modified/added JS/TS/Vue files using git diff.
2. Runs static analysis: Executes the best available linter (ESLint, JSHint, or TypeScript compiler).
3. Performs AI review: Sends the combined context to Gemini CLI for intelligent analysis.
4. Returns structured results: Provides a JSON response with findings and recommendations.

Example output format:

{
  "summary": "Overview of changes made",
  "assessment": "Overall code quality evaluation",
  "findings": [
    {
      "filePath": "src/example.js",
      "lineNumber": 42,
      "severity": "warning",
      "category": "style",
      "comment": "Detailed explanation of the issue",
      "suggestion": "Specific recommendation for improvement"
    }
  ]
}

Note: If no relevant files have been changed, the tool will return a "No relevant files changed" message.

Advanced Usage

Using with Claude Code

For the best results, use specific keywords:

• Most reliable requests (recommended):
  • "Use the code review tool to analyze my changes"
  • "Run code review on my local changes"
  • "Perform a comprehensive code review of my uncommitted changes"
  • "Analyze my code changes with static analysis"
• Natural language requests (less reliable):
  • "Please review my local changes"
  • "Can you analyze the code changes I've made?"
• Explicit tool invocation (most reliable):
  • "Use the review-local-changes tool"
  • "Call the review-local-changes tool to check my modifications"

Local development

• npm run dev: Launches the server with ts-node for rapid iteration.
• npm run build: Produces the compiled JavaScript output in dist/.

📚 Documentation

Connect from MCP clients

Before connecting the server to any client, make sure dist/index.js exists by running npm run build.

Claude Code (VS Code extension)

1. In VS Code, open the command palette (Cmd/Ctrl+Shift+P) and run Claude: Edit Config File.
2. Locate the mcpServers section (create it if needed) and add an entry:

   {
     "mcpServers": {
       "ndlovu-code-reviewer": {
         "command": "node",
         "args": ["/absolute/path/to/ndlovu-code-reviewer/dist/index.js"],
         "cwd": "/absolute/path/to/ndlovu-code-reviewer"
       }
     }
   }
   

3. Save the file and run Claude: Restart Claude Code (or reload VS Code) so the server appears under Tools.
4. Enable the tool for a conversation; Claude Code will stream review-local-changes results in the sidebar.

Gemini CLI

1. From the project root run:

   gemini mcp add ndlovu-code-reviewer node $(pwd)/dist/index.js
   

2. Verify the registration with gemini mcp list.
3. Launch gemini from the same repository directory and use the review-local-changes tool.

Roo Code

1. Open Roo Code and click the server icon in the top of the Roo panel.
2. Choose Add MCP Server → STDIO and fill in:
   • Name: ndlovu-code-reviewer
   • Command: node
   • Arguments: /absolute/path/to/ndlovu-code-reviewer/dist/index.js
   • Working Directory: /absolute/path/to/ndlovu-code-reviewer
3. Save the configuration and enable the server for your workspace.
4. To share with teammates, commit a .roo/mcp.json with your preferred launch command:

   {
     "mcpServers": {
       "ndlovu-code-reviewer": {
         "command": "npm",
         "args": ["run", "start"],
         "cwd": "."
       }
     }
   }
   

Codex CLI

1. Register the server once:

   codex mcp add ndlovu-code-reviewer node $(pwd)/dist/index.js
   

2. Use codex mcp list to confirm the entry, then start Codex from the repository root and call review-local-changes inside interactive runs.

🤝 Contributing

Contributions are highly welcome. If you have ideas for new tools, better linters, or improved prompts:

1. Open an issue or discussion to align on scope.
2. Fork the repository and create a feature branch.
3. Add or update documentation/tests to assist future contributors.
4. Submit a pull request describing the change and validation process.

📄 License

This project is licensed under the ISC License. See LICENSE (if present) for details.