Skip to main content
Glama

deltaprobe πŸ”

CI npm MCP Registry License: MIT

Give your AI assistant x-ray vision into pull requests.

deltaprobe is a Model Context Protocol (MCP) server that lets AI assistants like Claude, Cursor and VS Code Copilot probe GitHub pull requests: list them, read their diffs, summarize changes, flag risky patches and post review comments.

Available on npm and the official MCP Registry as io.github.Deepthi-04/deltaprobe.

Tools

Tool

Status

Description

list_open_prs

βœ…

List open PRs in a repo, most recently updated first

summarize_pr

βœ…

Overview of a PR: description, size, file types, most-touched areas, review status and CI results

get_pr_diff

βœ…

Fetch changed files and diff hunks, trimmed to whole hunks within a character budget

check_pr_risk

βœ…

Rule-based risk checks: secrets in added lines (masked), sensitive files, large diffs, missing tests, CI/migration/dependency changes, debug code

post_review_comment

βœ…

Post a review with inline comments; every line is checked against the diff first, with a dryRun preview

Related MCP server: GitHub PR Reviewer

How it works

You: "Review PR #42 in acme/app"
        β”‚
        β–Ό
AI assistant ──(MCP over stdio)──► deltaprobe ──► GitHub API
        β–²                               β”‚
        └──── structured PR data β—„β”€β”€β”€β”€β”€β”€β”˜

The assistant decides which deltaprobe tools to call, deltaprobe fetches and trims the data from GitHub, and the assistant writes the review.

Quick start

Prerequisites

  • Node.js 20+ (22.12+ for development)

  • A GitHub token (create one). Optional for reading public repos, but it raises the rate limit from 60 to 5,000 requests/hour. post_review_comment needs one with Pull requests: Read and write permission.

Use with Claude Code

# public repos, read-only (no token)
claude mcp add deltaprobe -- npx -y deltaprobe

# with a token (higher rate limit, private repos, posting reviews)
claude mcp add deltaprobe -e GITHUB_TOKEN=<your-token> -- npx -y deltaprobe

Use with Claude Desktop / Cursor

Add to your MCP config:

{
  "mcpServers": {
    "deltaprobe": {
      "command": "npx",
      "args": ["-y", "deltaprobe"],
      "env": { "GITHUB_TOKEN": "<your-token>" }
    }
  }
}

Then ask: "What are the open PRs in modelcontextprotocol/typescript-sdk?"

Development

git clone https://github.com/Deepthi-04/deltaprobe.git
cd deltaprobe
npm install
npm test          # run unit tests
npm run build     # compile TypeScript to dist/
npm run dev       # run the server from source

Project structure

src/
β”œβ”€β”€ index.ts          # MCP server entry: registers tools, connects over stdio
β”œβ”€β”€ github.ts         # GitHub API client
β”œβ”€β”€ diff.ts           # hunk splitting, budget fitting, commentable lines
β”œβ”€β”€ files.ts          # file type and area classification
β”œβ”€β”€ risk/rules.ts     # risk rules: each takes the PR's files and returns findings
└── tools/            # one file per tool
test/                 # vitest unit tests

Roadmap

  • list_open_prs

  • get_pr_diff with smart truncation

  • summarize_pr

  • check_pr_risk rules

  • post_review_comment

  • CI on GitHub Actions

  • Publish to npm and the MCP Registry

  • List on Smithery

  • GitHub Action that reviews PRs automatically

License

MIT

Available Tools

5 tools
check_pr_riskCheck pull request riskA
Read-only

Run rule-based risk checks on a pull request: possible secrets in added lines (masked), sensitive files, large diffs, source changes without tests, CI workflow, migration and dependency changes, and leftover debug code. Returns an overall level (none/low/medium/high) and findings with file and line where possible. These are heuristics: confirm each finding by reading the code with get_pr_diff before reporting it.

Inputs: repo (required), owner (required), pullNumber (required).

get_pr_diffGet pull request diffA
Read-only

Get the changed files and unified diff hunks of a pull request. Patches are trimmed to whole hunks within a character budget; lock files and build output are skipped. Every file is listed, and files without a patch have an 'omitted' reason. If 'truncated' is true, call again with 'files' to read specific files in full.

Inputs: repo (required), owner (required), pullNumber (required), files, +1 more.

list_open_prsList open pull requestsA
Read-only

List open pull requests in a GitHub repository, most recently updated first. Use this to find which PR to review.

Inputs: repo (required), owner (required), limit.

post_review_commentPost pull request reviewA

Post a review on a pull request: an overall summary plus optional inline comments on specific lines. Inline comments must target lines in the PR's diff (RIGHT = new version, LEFT = removed lines); they're all checked first, and nothing is posted if any is invalid. Defaults to a neutral COMMENT review. Use dryRun to preview. Requires a GITHUB_TOKEN that can write to pull requests. Only post when the user has asked you to.

Inputs: body (required), repo (required), owner (required), pullNumber (required), +3 more.

summarize_prSummarize pull requestA
Read-only

Get an overview of a pull request without its diff: title, description, author, branches, labels, size, file types (source/test/docs/config/generated), most-touched areas, review status and CI check results. Call this first when reviewing a PR, then use get_pr_diff to read the code.

Inputs: repo (required), owner (required), pullNumber (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct stage of PR review: listing (list_open_prs), overview metadata (summarize_pr), code content (get_pr_diff), heuristic risk scanning (check_pr_risk), and writing feedback (post_review_comment). Descriptions explicitly state sequencing and warn against confusing heuristics with actual code reading, leaving no ambiguity.

    Naming Consistency5/5

    All five names follow a consistent snake_case verb_noun pattern (list_, get_, summarize_, check_, post_) with a shared 'pr' domain noun. No mixed conventions or vague verbs.

    Tool Count5/5

    Five tools map cleanly onto a coherent review workflow with no redundancy or filler. Each tool covers a necessary and non-overlapping step from discovery to posting a review.

    Completeness4/5

    The surface covers the core review lifecycle: discover PRs, understand them, read diffs, assess risk, and post comments with inline feedback. Minor gaps remain around reading existing review threads/replies and retrieving CI log details, but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers