hevangel avatar

Batch Review

hevangel/batch-review-mcp

This bridges human code reviewers and AI agents in a single collaborative session. It spins up a three-panel web UI showing file trees, git diffs, and comment threads, while simultaneously exposing the same review state over MCP stdio so Claude or Cursor can add structured comments alongside you. The browser renders markdown with KaTeX math and Mermaid diagrams, shows inline unified diffs for changed files, and lets you highlight paragraphs or code ranges to anchor comments. All comments save to both JSON and markdown reports. The MCP tools let agents read diffs, list files, add comments with line references, and save the final review. Useful when you want AI feedback on pull requests or documentation without switching contexts between your editor and a separate review tool.

GitHub stars
2
tools
22
transport
STDIO
last updated
Sep 5, 2026

Tools

22 tools

Public tool metadata for what this MCP can expose to an agent.

init_batch_review_sessionCall first; returns an application session_id. Pass it to later tools for modern stateless MCP; legacy connection-scoped clients may omit it.

Call first; returns an application session_id. Pass it to later tools for modern stateless MCP; legacy connection-scoped clients may omit it.

No parameter schema in public metadata yet.

get_current_useridReturn the userid used for future comments in that application session

Return the userid used for future comments in that application session

No parameter schema in public metadata yet.

set_current_useridChange the userid for future comments in that application session only

Change the userid for future comments in that application session only

No parameter schema in public metadata yet.

get_git_changesList changed files vs HEAD

List changed files vs HEAD

No parameter schema in public metadata yet.

get_git_diffUnified diff + original/modified content

Unified diff + original/modified content

No parameter schema in public metadata yet.

add_commentAdd a review comment; source comments use line ranges, while DOCX/PPTX comments can use document_kind, document_page, normalized regions, document_anchor, and document_fingerprint; shows a short notice in the UI

Add a review comment; source comments use line ranges, while DOCX/PPTX comments can use document_kind, document_page, normalized regions, document_anchor, and document_fingerprint; shows a short notice in the UI

No parameter schema in public metadata yet.

update_commentEdit comment body; UI notice

Edit comment body; UI notice

No parameter schema in public metadata yet.

delete_commentDelete a comment; UI notice

Delete a comment; UI notice

No parameter schema in public metadata yet.

clear_all_commentsRemove every in-memory comment at once; UI notice

Remove every in-memory comment at once; UI notice

No parameter schema in public metadata yet.

delete_outdated_commentsRemove comments with outdated true; UI notice

Remove comments with outdated true; UI notice

No parameter schema in public metadata yet.

list_commentsList all in-memory comments

List all in-memory comments

No parameter schema in public metadata yet.

recompute_comment_staleRe-scan files vs highlighted_text and set each comment's outdated flag; UI notice

Re-scan files vs highlighted_text and set each comment's outdated flag; UI notice

No parameter schema in public metadata yet.

list_review_filesList stems of *.json reviews in output_dir

List stems of *.json reviews in output_dir

No parameter schema in public metadata yet.

load_review_by_stemReplace comments from {stem}.json; UI notice

Replace comments from {stem}.json; UI notice

No parameter schema in public metadata yet.

save_commentsSave JSON + Markdown report, returns paths

Save JSON + Markdown report, returns paths

No parameter schema in public metadata yet.

get_file_contentRead file content as structured data (content, line_count, language, path) when diff context alone is not enough

Read file content as structured data (content, line_count, language, path) when diff context alone is not enough

No parameter schema in public metadata yet.

list_directoryMinimal repo navigation helper for hosts that want the review file tree

Minimal repo navigation helper for hosts that want the review file tree

No parameter schema in public metadata yet.

open_file_in_uiOpen a file in the center panel (view or diff); same path+mode refreshes the view

Open a file in the center panel (view or diff); same path+mode refreshes the view

No parameter schema in public metadata yet.

highlight_in_uiSource files: line_start–line_end (1-based). PDFs: pdf_page + region_* normalized 0–1 on that page. Images: region_* in original pixels. DOCX/PPTX: document_page + normalized region_* (and optional document_kind/anchor fields)

Source files: line_start–line_end (1-based). PDFs: pdf_page + region_* normalized 0–1 on that page. Images: region_* in original pixels. DOCX/PPTX: document_page + normalized region_* (and optional document_kind/anchor fields)

No parameter schema in public metadata yet.

jump_to_comment_in_uiSame as clicking a comment's @file:L… link: open the file and highlight that anchor

Same as clicking a comment's @file:L… link: open the file and highlight that anchor

No parameter schema in public metadata yet.

get_configReturn save defaults, web/protocol details, and public MCP client display metadata (never session capabilities or per-session userids)

Return save defaults, web/protocol details, and public MCP client display metadata (never session capabilities or per-session userids)

No parameter schema in public metadata yet.

get_review_web_urlReturn web_ui, websocket, and mcp_http URLs for the running app

Return web_ui, websocket, and mcp_http URLs for the running app

No parameter schema in public metadata yet.

Sponsors

Readme

Batch Review

A collaborative code and markdown review tool that bridges human reviewers and AI agents. Both can browse files, inspect git diffs, leave structured comments, and save a final review report — all from the same UI, in real time.

Batch Review UI — file tree on the left, rendered Markdown with GitHub-style math equations and a WaveDrom timing diagram in the centre, and the review comments panel on the right


Features


View the full README on GitHub

Details

Repository
github.com/hevangel/batch-review-mcp
Website
github.com/hevangel/batch-review-mcp
Categories
Developer Tools, Documents & Knowledge
Package
https://github.com/hevangel/batch-review-mcp/releases/download/v1.3.0/batch-review-mcp-1.3.0.mcpb
Transport
STDIO
Registry
MCP registry, active

Related Developer Tools MCP servers

View all
1automatelab-tech avatarContent Distributionautomatelab-tech/content-distribution-mcpPublish content to DEV.to, Hashnode, GitHub Discussions, Reddit, Bluesky, LinkedIn, and Medium.2stars
2lu-zhengda avatarVirtual Filesystemlu-zhengda/mcp-virtual-fsPostgreSQL-backed virtual filesystem for agents: session isolation, shared stores, POSIX ops, RLS.2stars
3scrape-badger avatarScrapeBadgerscrape-badger/scrapebadger-mcpTwitter/X, Google, Facebook Marketplace, Yelp, GitHub and AutoScout24 for AI agents.2stars
4jonesrobm avatarPhysboundjonesrobm/physboundPhysical Layer Linter: validates RF and radar calculations against hard physical limits.2stars
5marin1321 avatarMcp Devtoolsmarin1321/mcp-devtoolsMCP server giving AI agents safe access to filesystem, databases, processes, and APIs.2stars
6qiuwenzheng avatarInterminalqiuwenzheng/interminalLightweight MCP server providing terminal access (SSH & local shells) for AI assistants.2stars