explaingit

frangelbarrera/code-review-agent-mcp

Analysis updated 2026-05-18

5PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

An MCP server that plugs into AI coding assistants to give blunt, line-specific code reviews with clear severity labels and a ship or do not merge verdict.

Mindmap

mindmap
  root((Code Review Agent MCP))
    What it does
      Reviews code diffs and files
      Severity labeled findings
      Blunt no-hedge tone
    Tech stack
      Python
      MCP protocol
      pip package
    Use cases
      Pre-merge code review
      Security bug detection
      Commit review
    Audience
      Developers
      AI assistant users
      Team leads

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Review a code snippet or file for bugs and security issues before merging

USE CASE 2

Get a blunt, direct review of a git diff or commit instead of a softened one

USE CASE 3

Catch SQL injection and other OWASP-style vulnerabilities in your code

USE CASE 4

Choose a harshness level from gentle to maximum bluntness for reviews

What is it built with?

PythonMCPpipClaude DesktopCursor

How does it compare?

frangelbarrera/code-review-agent-mcp1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencedeveloperops devopsgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Python 3.10+ and an MCP-compatible client such as Claude Desktop or Cursor.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Code Review Agent MCP is a tool that plugs into AI coding assistants like Claude Desktop or Cursor and gives them the ability to review code the way a strict, experienced maintainer would, without softening the message. It connects using MCP, a protocol that lets AI assistants call outside tools, so once installed you can ask your assistant to review a code snippet, a whole file, a git diff, or a specific commit, and it will return findings directly through the conversation. Each finding gets a severity label of critical, major, minor, nit, or clean, points to the exact line number involved, explains what is wrong and how to fix it, and ends with a clear verdict of either ship it or do not merge until the problems are fixed. The project was built specifically to avoid the overly polite tone many AI tools default to, where criticism gets buried under phrases like great work but or you might want to consider. Instead it aims to sound like reviewers on serious open source projects such as the Linux kernel, who state problems plainly because their goal is a better result, not a nicer conversation. To keep that blunt tone consistent, the project uses three layers working together: a detailed system prompt with rules against hedging and false praise, a post processing step that strips out dozens of softening phrases from the output, and a validator that checks each review actually includes severity labels, line citations, and a verdict. There are also four harshness levels to choose from, ranging from gentle to a maximum bluntness kernel maintainer mode. The tool specifically watches for security issues like SQL injection alongside general bugs such as logic errors, race conditions, and resource leaks, and it is designed to explicitly say when code is clean rather than inventing problems that are not there. It includes sandboxing so file access stays limited to the current project folder and refuses to touch sensitive paths. It is installed through pip, written in Python, and released under the MIT license.

Copy-paste prompts

Prompt 1
Help me install and configure code-review-agent-mcp in Claude Desktop
Prompt 2
Review this code snippet for bugs and security issues using the blunt reviewer
Prompt 3
Set up code-review-agent-mcp in Cursor and review my last git commit
Prompt 4
Explain how the anti-RLHF post-processor strips hedging language from reviews
Prompt 5
Show me how to review a git diff using the review_diff tool

Frequently asked questions

What is code-review-agent-mcp?

An MCP server that plugs into AI coding assistants to give blunt, line-specific code reviews with clear severity labels and a ship or do not merge verdict.

What language is code-review-agent-mcp written in?

Mainly Python. The stack also includes Python, MCP, pip.

What license does code-review-agent-mcp use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is code-review-agent-mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is code-review-agent-mcp for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.