critique-mcp

에이전트에게 풀 리퀘스트를 실제로 리뷰할 수 있는 도구를 제공하는 MCP 서버입니다 — diff를 요약하는 데 그치지 않고, diff를 뜯어보고, 변경된 코드를 린트하며, 테스트가 함께 업데이트되지 않았으면 플래그를 표시하고, 실제 리뷰를 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의 값을 반환하지 않는 빈 그릇 통과(공허한 통과) assertion, weaviate-python-client의 리스트의 요소 하나만 검사한 validator, 그리고 qdrant-client의 부동소수점 그런 정밀도 버그. 이 프로젝트는 그 리뷰 과정을 에이전트가 직접 호출할 수 있는 도구 형태로 바꿔 놓은 것입니다. 이제 사람이 당해 같은 검사를 매번 손으로 반복하지 않아도 됩니다.

설정

필요 사항: Python 3.11 이상, PATH에 있는 ruff, repo 스코프가 있는 GitHub personal access token. post_review를 쓰는 일이 아니라면 read-only 토큰으로도 충분합니다.

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 호출은 테스트에서 mock 처리됩니다. 서버를 직접 실행하지 않는다면 live 네트워크 호출은 일어나지 않습니다.