Skip to main content
Glama
ReviewLens MCP Server

ReviewLens MCP Server

by pgf3712

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.

ReviewLens MCP product walkthrough

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.

Simulated pull-request review with structured evidence

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.

ReviewLens tools and architecture

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.

ReviewLens security model and creator signature

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-demo

Open http://127.0.0.1:8000. The demo always uses deterministic fixture data.

Run the MCP server

reviewlens-mcp

The 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
pytest

Documentation

  • Spanish: README.es.md

  • Recording guide: docs/demo-recording.md

  • Limitations: docs/limitations.md

Author

Built by Paula García Fernández.

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 tools
build_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

    B3/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
    • A
      license
      A
      quality
      D
      maintenance
      Connects 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.
      13
      1
      MIT