critique-mcp

エージェントがプルリクエストを実際にレビューするためのツールを提供するMCPサーバーです。diffを要約するだけでなく、diffを分解して精査し、変更されたコードをlintし、テストが更新されていないことを検出して、実際のレビューをGitHubに投稿します。

Python · Model Context Protocol · GitHub REST API

ツール

各ツールは、薄く独立してテスト可能な関数です。run_linterはcheck_test_coverageの仕組みを知りません。また、どちらもGitHubClientを経由しない限りGitHubと通信しません。組み合わせ方はエージェントが決めます。このサーバーは、そのための手を与えるだけです。

check_test_coverageはPRレベルのヒューリスティックであり、ファイル単位のカバレッジ計測ではありません。「ソースファイルが変更されているのに、このPR内でどのテストファイルにも触れていない」ことを検出します。これはDanger.jsのようなツールが使うのと同じ粗いシグナルです。5つのソースファイルを変更し、無関係なテストファイルを1つだけ変更したPRは警告されません。正確な判定には、ファイル名ではなく実際のカバレッジデータが必要です。

Related MCP server: github-pr-review-mcp

なぜ存在するのか

私は、こうしたツールが検出する種類のバグを、他の人のPRで手動でも見つけ、修正してきました。chroma-core/chromaの自明にパスするだけのテストアサーション、weaviate-python-clientのリストの1要素しかチェックしていなかったバリデーター、qdrant-clientの浮動小数点精度に関するバグ。これにより、そのレビュープロセスが、エージェントが直接呼び出せるツール群になります。人間が毎回同じチェックを手作業で行う必要はありません。

セットアップ

Python 3.11以上、PATHにruff、およびrepoスコープを持つGitHub personal access tokenが必要です（post_reviewを機能させる場合を除き、読み取り専用で十分です）。

cp .env.example .env      # then add your token to .env
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

使い方

Claude Desktop / Claude CodeのMCP設定に追加します。

{
  "mcpServers": {
    "critique": {
      "command": "python",
      "args": ["-m", "critique_mcp.server"],
      "env": { "GITHUB_TOKEN": "ghp_..." }
    }
  }
}

そのうえでエージェントに「critiqueを使ってowner/repoのPR #42をレビューしてください。lintの問題とテスト不足を確認して、要約レビューを投稿してください」と依頼します。

テスト

pytest

すべてのGitHub API呼び出しはテスト内でモックされています。サーバー自体を実行しない限り、実際のネットワーク呼び出しは発生しません。