ReviewLens MCP Server
Provides tools for reviewing pull requests on GitHub, including listing PRs, fetching metadata, files, diffs, searching code, and assembling structured review reports.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ReviewLens MCP Server Review pull request #42 for potential issues."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ReviewLens MCP
A secure, explainable MCP server for AI-assisted GitHub pull-request review.
ReviewLens exposes seven typed, read-only tools that collect evidence from pull requests. It separates deterministic evidence collection from model interpretation, treats repository content as untrusted data, and includes a credential-free simulated provider and web demo.

Why it exists
AI review assistants often collapse retrieval, interpretation, and action into one opaque step. ReviewLens keeps those concerns separate so tool calls are auditable, contracts are testable, and no model can mutate a repository through this server.
Related MCP server: pr-forge
Product tour
The deterministic demo completes a realistic pull-request review without requiring a GitHub token. It exposes the collected evidence, related tests, risk level, and any instruction-like content found in untrusted repository data.

The tool surface is intentionally small: seven operations with explicit inputs and one responsibility each. The architecture keeps MCP at the adapter boundary and isolates review logic from GitHub access.

The security model is visible rather than implied: least privilege, bounded evidence, untrusted-content handling, and explicit failures. A restrained pixel-art signature connects the project to its creator without competing with the engineering content.

Quick start — demo mode
python -m venv .venv
# Windows: .venv\Scripts\activate
# macOS/Linux: source .venv/bin/activate
python -m pip install -e ".[dev]"
pytest
reviewlens-demoOpen http://127.0.0.1:8000. The demo always uses deterministic fixture data.
Run the MCP server
reviewlens-mcpThe default transport is stdio.
Tools
Tool | Purpose |
list_pull_requests | List open pull requests |
get_pull_request | Fetch PR metadata |
get_pull_request_files | Collect changed files and patches |
get_pull_request_diff | Return a bounded, redacted diff |
search_repository_code | Search repository code |
find_related_tests | Locate tests connected to changed paths |
build_review_report | Assemble deterministic structured evidence |
Live mode
Copy .env.example to .env, set REVIEWLENS_MODE=live, and optionally configure a fine-grained token or GitHub App installation token with read-only Contents and Pull requests permissions. Tokens remain server-side.
Architecture and security
See docs/architecture.md, docs/security.md, and docs/adr/. The MVP contains no write-capable provider method, MCP tool, or demo endpoint.
Verification
ruff check .
mypy src
pytestDocumentation
Spanish: README.es.md
Recording guide: docs/demo-recording.md
Limitations: docs/limitations.md
Author
Built by Paula García Fernández.
Copyright
Copyright © 2026 Paula García Fernández. All rights reserved. The repository is viewable as a personal portfolio and technical demonstration; reuse requires prior written permission. See COPYRIGHT.md. Audio is intentionally absent from v1.
Available Tools
7 toolsbuild_review_reportC
Build deterministic structured evidence; never asks an LLM for a verdict.
Inputs: repo (required), owner (required), number (required). Returns: object
get_pull_requestC
Get typed pull-request metadata.
Inputs: repo (required), owner (required), number (required). Returns: object
get_pull_request_diffC
Get a bounded, redacted unified diff.
Inputs: repo (required), owner (required), number (required). Returns: object
get_pull_request_filesC
Get changed files and patches for a pull request.
Inputs: repo (required), owner (required), number (required). Returns: result
list_pull_requestsC
List open pull requests without changing the repository.
Inputs: repo (required), owner (required), limit. Returns: result
search_repository_codeC
Search code in a repository using a bounded query.
Inputs: repo (required), owner (required), query (required), limit. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a mostly distinct purpose: listing PRs, fetching metadata, fetching diffs/files, finding tests, searching code, and building a report. The main overlap is between get_pull_request_diff and get_pull_request_files, since both expose changed content, though the descriptions distinguish unified diff from file-level patches.
All tools use a consistent snake_case verb_noun pattern, such as get_pull_request, list_pull_requests, find_related_tests, and build_review_report. The naming is predictable and easy to scan.
Seven tools are well-scoped for a read-only PR review/evidence server. Each tool supports a clear part of the review workflow, and there is no obvious bloat.
The surface covers core read-only review needs: listing PRs, fetching metadata, diffs, changed files, related tests, code search, and report generation. Minor gaps remain around existing review comments, CI/check status, or commit context, but the core workflow is workable.
Maintenance
Related MCP Connectors
Screens public GitHub repos and PRs to generate risk maps, findings, and merge-readiness signals.
Versioned artifact review for people and AI agents, with contextual comments and human control.
Read-only AI coding tools for change verification, release readiness, capacity, and guidance.
AI-native git hosting — repos, PRs, issues, CI gates, and AI code review over MCP (60 tools).
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables LLM clients to list, read, review, and comment on GitHub pull requests, turning an AI assistant into a fully capable code reviewer.61-
- AlicenseNot gradedqualityDmaintenanceProvides AI agents with a secure PR review gateway through 9 MCP tools for managing pull requests, including context retrieval, diff, checks, and merge with two-layer access control.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to autonomously review GitHub Pull Requests by listing PRs, retrieving diffs, and submitting structured reviews.ISC
- AlicenseAqualityDmaintenanceConnects AI assistants to GitHub repositories, pull requests, issues, commits, and code search while enabling repository visibility controls, CI/CD monitoring, sandboxed local filesystem access, and code quality/security analysis.131MIT