critique-mcp
critique-mcp
에이전트에게 풀 리퀘스트를 실제로 리뷰할 수 있는 도구를 제공하는 MCP 서버입니다 — diff를 요약하는 데 그치지 않고, diff를 뜯어보고, 변경된 코드를 린트하며, 테스트가 함께 업데이트되지 않았으면 플래그를 표시하고, 실제 리뷰를 GitHub에 다시 게시합니다.
Python · Model Context Protocol · GitHub REST API
도구
도구 | 하는 일 |
| PR에서 변경된 파일, diff 통계 및 패치 텍스트 |
| 테스트 파일을 하나도 건드리지 않고 소스 파일을 변경한 PR에 플래그 표시 |
| PR의 head commit에서 변경된 모든 Python 파일에 대해 |
| PR에 실제 리뷰(comment / approve / request changes) 제출 |
각 도구는 가볍고 독립적으로 테스트 가능한 함수입니다. run_linter는 check_test_coverage가 어떻게 동작하는지 알지 못하고, 둘 다 GitHubClient를 통해서만 GitHub와 통신합니다. 도구를 어떻게 조합할지는 에이전트가 결정합니다. 이 서버는 그저 도구를 쥐어 주는 역할만 할 뿐입니다.
check_test_coverage는 파일별 커버리지를 계측하는 도구가 아니라 PR 수준의 휴리스틱입니다. 이 도구는 "소스 파일은 변경되었지만 PR 전체에서 테스트 파일은 하나도 건드리지 않았다"를 플래그로 잡아내는, Danger.js처럼 큰 결에서 보는 판단 같은 것이라고 할 수 있습니다. 소스를 5개 변경하고 관련 없는 테스트 파일 1개를 만진 PR은 플래그가 붙지 않습니다. 정밀한 판단을 원한다면 파일 이름이 아니라 실제 커버리지 데이터가 필요합니다.
Related MCP server: GitHub PR Reviewer
왜 만들어졌나
이 도구들과 정확히 같은 종류의 버그를 다른 사람의 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 네트워크 호출은 일어나지 않습니다.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Assess pull requests and read verdicts, findings, evidence and suggested fixes from coding agents.
Operate GitHub from your AI assistant: repos, PRs, issues, Actions. Previews and read-only mode.
Lets coding agents check their own code for leaked secrets, risky dependencies and AI-code mistakes
Many AI agents on one repo, every change lands on main. Read code, propose changes, review, read CI.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides GitHub PR review capabilities to LLMs, enabling automated PR analysis, review submission, and inline commenting via MCP.1426 npm1MIT
- AlicenseNot gradedqualityDmaintenanceEnables reviewing GitHub pull requests via ChatGPT, including listing PRs, viewing diffs, posting comments, approving, and requesting changes.MIT
- FlicenseAqualityDmaintenanceEnables LLM clients to list, read, review, and comment on GitHub pull requests, turning an AI assistant into a fully capable code reviewer.61-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to autonomously review GitHub Pull Requests by listing PRs, retrieving diffs, and submitting structured reviews.ISC