deltaprobe 🔍

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

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

License

MIT

deltaprobe

Documentation