Ndlovu Code Reviewer

ndlovu-code-reviewer is an MCP server that provides AI-powered static analysis and code review for local, uncommitted changes. Built using the Model Context Protocol TypeScript SDK, it connects directly to MCP clients over standard I/O and bridges your local Git workspace with the Google Gemini CLI. Software developers working in JavaScript, TypeScript, and Vue projects use this server to automate the pre-commit review process without relying on expensive SaaS tools. The server gathers diffs from modified or staged files using git diff and runs available linters such as ESLint, JSHint, or the TypeScript compiler. It bundles these static analysis findings with the Git context and forwards them safely to the Gemini CLI. The output is parsed and returned to the MCP client as a structured JSON object containing an executive summary, overall assessment, and line-specific findings with severity levels, explanations, and actionable code suggestions.

Category: Developer Tools & Code Intelligence

Tags: code-review, javascript, linting, static analysis, typescript

Visit Ndlovu Code Reviewer

How to install and configure Ndlovu Code Reviewer

1. Clone the repository and install dependencies: bash git clone https://github.com/shaunie2fly/ndlovu-code-reviewer.git cd ndlovu-code-reviewer npm install npm run build 2. Ensure Node.js 18+, Git, and an authenticated Google Gemini CLI (gemini) are installed. 3. Open your MCP client configuration (e.g., Claude Code configuration via Claude: Edit Config File in VS Code). 4. Add ndlovu-code-reviewer under mcpServers: json { "mcpServers": { "ndlovu-code-reviewer": { "command": "node", "args": ["/absolute/path/to/ndlovu-code-reviewer/dist/index.js"], "cwd": "/absolute/path/to/ndlovu-code-reviewer" } } } 5. Restart your client and invoke the review-local-changes tool.

What you can do with Ndlovu Code Reviewer

• Reviewing uncommitted Git modifications across JavaScript, TypeScript, and Vue files before opening a team pull request. - Running automated static linter checks using ESLint, JSHint, or tsc alongside contextual AI evaluation in Claude Code. - Generating structured JSON reports of code issues with specific file paths, line numbers, categories, and suggested fixes. - Integrating automated local pre-commit analysis into Gemini CLI, Codex CLI, or Roo Code developer workflows.

Key facts

• Open Source
• https://github.com/shaunie2fly/ndlovu-code-reviewer
• Developer Tools & Code Intelligence, DevOps, CI/CD & Version Control
• code-review, javascript, linting, static analysis, typescript

Part of MCP Servers

How do I install ndlovu-code-reviewer?

Clone the repository from GitHub, run npm install, and run npm run build. Ensure you have Node.js 18 or later, Git, and an authenticated Gemini CLI installed. Then register the compiled dist/index.js path under your MCP client's configuration file.

What can ndlovu-code-reviewer do?

It provides a tool called review-local-changes that scans uncommitted changes in JS, TS, and Vue files. It executes local linters including ESLint, JSHint, or TypeScript, passes the diffs and linter reports to the Gemini CLI, and outputs structured review assessments.

Which MCP clients work with ndlovu-code-reviewer?

It connects over standard I/O and works with Claude Code, Gemini CLI, Roo Code, Codex CLI, and any other desktop or terminal client supporting the Model Context Protocol specification.

What programming languages are supported?

The server currently targets JavaScript, TypeScript, and Vue applications using file extensions such as .js, .ts, .tsx, and .vue. Linting falls back across ESLint, JSHint, and the TypeScript compiler depending on what is installed.

Is ndlovu-code-reviewer open source?

Yes, ndlovu-code-reviewer is an open-source project distributed under the ISC License. Source code, documentation, and contribution guidelines are publicly available on GitHub.