deltaprobe

deltaprobe 🔍

AI アシスタントにプルリクエストの X 線視力を与えます。

deltaprobe は、Claude、Cursor、VS Code Copilot などの AI アシスタントが GitHub のプルリクエストを調べられるようにする Model Context Protocol (MCP) サーバーです。プルリクエストの一覧表示、差分の読み取り、変更内容の要約、リスクのあるパッチの検出、レビューコメントの投稿ができます。

npm と公式 MCP Registry で io.github.Deepthi-04/deltaprobe として利用できます。

ツール

ツール	状態	説明
list_open_prs	✅	リポジトリ内のオープンな PR を、更新日時の新しい順に一覧表示します
summarize_pr	✅	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 トークン（作成はこちら）。公開リポジトリの読み取りには任意ですが、指定するとレート制限が 1 時間あたり 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 のオープンな PR を教えてください」

開発

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 に掲載
• PR を自動レビューする GitHub Action

ライセンス

MIT