critique-mcp

Ein MCP-Server, der einem Agenten die Werkzeuge gibt, einen Pull-Request wirklich zu begutachten – nicht nur den Diff zusammenzufassen, sondern ihn auseinanderzunehmen, den geänderten Code zu linten, zu markieren, wenn Tests nicht aktualisiert wurden, und ein echtes Review auf GitHub zu posten.

Python · Model Context Protocol · GitHub REST API

Werkzeuge

Jedes Werkzeug ist eine schlanke, unabhängig testbare Funktion – run_linter weiß nicht, wie check_test_coverage funktioniert, und keines von beiden spricht außer über GitHubClient mit GitHub. Der Agent entscheidet, wie er sie kombiniert; dieser Server liefert nur die Hände dazu.

check_test_coverage ist eine Heuristik auf PR-Ebene, keine pro Datei arbeitende Coverage-Messung: Sie kennzeichnet „Quelldateien geändert, aber keine Testdatei berührt im gesamten PR“ – dasselbe grobe Signal, das Werkzeuge wie Danger.js verwenden. Ein Pull-Request, der fünf Quelldateien ändert und eine unzusammenhängende Testdatei anfasst, wird nicht markiert – eine präzisere Version brächte echte Coverage-Daten nötig, nicht Dateinamen.

Related MCP server: github-pr-review-mcp

Warum es das gibt

Ich habe genau die Art von Fehler, die diese Werkzeuge aufspüren, von Hand in anderen Pull Requests gefunden und behoben: eine Test-Assertion, die ohne echte Prüfung immer bestand, in chroma-core/chroma; einen Validator, der in weaviate-python-client nur ein Listenelement prüfte; und einen Gleitkomma-Präzisionsfehler in qdrant-client. Das verwandelt genau diesen Review-Prozess in Werkzeuge, die ein Agent direkt aufrufen kann, statt dass per Hande dasselbe Prüpfeln jedes Mal von einem Menschen wiederholt werden.

Einrichtung

Erforderlich sind Python 3.11+, ruff im PATH sowie ein persönliches GitHub-Zugriffstoken mit dem repo-Bereich (read-only genügt, außer post_review soll funktionieren).

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

Verwendung

Fügen Sie ihn zur MCP-Konfiguration von Claude Desktop / Claude Code hinzu:

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

Dann bitte den Agenten, es zu verwenden: „Verwende critique, um PR #42 auf owner/repo zu begutachten – prüfe auf Lint-Versionen und fehlende Tests und poste danach ein zusammenfassendes Review.“"

Tests

pytest

Jeder GitHub-API-Aufruf wird in Tests gemockt – es gibt hier niemals einen echten Netzwerkaufruf, außer du oh den Server selbst ausführst.