deltaprobe

deltaprobe 🔍

为你的 AI 助手提供透视拉取请求的 X 射线视野。

deltaprobe 是一个 Model Context Protocol（MCP） 服务，可让 Claude、Cursor 和 VS Code Copilot 等 AI 助手检查 GitHub 拉取请求：列出拉取请求、读取差异、总结更改、标记高风险补丁并发布审查评论。

可在 npm 和官方 MCP Registry 上获取，包名为 io.github.Deepthi-04/deltaprobe。

工具

工具	状态	描述
list_open_prs	✅	列出仓库中尚未关闭的拉取请求，按最近更新时间从新到旧排列
summarize_pr	✅	拉取请求概览：描述、规模、文件类型、改动最频繁的区域、审查状态和 CI 结果
get_pr_diff	✅	获取已更改的文件和差异块，并在字符数限制内按完整差异块截断
check_pr_risk	✅	基于规则的风险检查：新增行中的密钥（已屏蔽）、敏感文件、大型差异、缺少测试、CI／迁移／依赖项更改、调试代码
post_review_comment	✅	发布包含行内评论的审查；每一行都会先与差异进行核对，并提供 dryRun 预览

工作原理

You: "Review PR #42 in acme/app"
        │
        ▼
AI assistant ──(MCP over stdio)──► deltaprobe ──► GitHub API
        ▲                               │
        └──── structured PR data ◄──────┘

助手会决定调用哪些 deltaprobe 工具，deltaprobe 从 GitHub 获取并截取数据，然后由助手撰写审查。

快速开始

前提条件

• Node.js 20+（开发需要 22.12+）
• GitHub 令牌（创建令牌）。读取公开仓库时可选，但令牌可将速率限制从每小时 60 次请求提高至 5,000 次。post_review_comment 需要具有 Pull requests: Read and write 权限的令牌。

搭配 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

搭配 Claude Desktop / Cursor 使用

添加到 MCP 配置中：

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

然后询问："modelcontextprotocol/typescript-sdk 中有哪些尚未关闭的拉取请求？"

开发

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

项目结构

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

路线图

• list_open_prs
• 支持智能截断的 get_pr_diff
• summarize_pr
• check_pr_risk 规则
• post_review_comment
• GitHub Actions 上的 CI
• 发布到 npm 和 MCP Registry
• 在 Smithery 上发布
• 自动审查拉取请求的 GitHub Action

许可证

MIT