Review Raven
scottlz0310/review-raven
Gerenciador de ciclos de revisão de PRs com watch assíncrono e notificações
Ver no GitHubServidor MCP para gerenciar ciclos de revisão de PRs em workflows com Copilot. Permite requisitar revisões, monitorar progresso em tempo real, detectar conclusão e rastrear estado de threads de revisão independentemente do provedor (Copilot, reviewers humanos ou bots). Construído sobre modelo assíncrono watch + notificação otimizado para agentes LLM.
Instalação
npx convez-ai scottlz0310/review-raven1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar requisição e monitoramento de revisões de código em PRs
- Rastrear progresso de revisões Copilot com notificações em tempo real
- Responder e resolver threads de revisão programaticamente via LLM agents
- Integrar workflows de revisão com pipelines de CI/CD e automação
Veredito

Ferramenta especializada para automação de workflows de revisão de PRs com Copilot. Requer deploy em mcp-gateway para autenticação e é ideal para times que precisam de revisões LLM assíncronas integradas em pipelines de desenvolvimento.
README
A tradução para o português deste README ainda está na fila.
review-raven
An MCP (Model Context Protocol) server for the reviewed side of a PR review workflow. Reads, replies to, and resolves review threads regardless of review provider (Copilot, human reviewer, or bot). Re-review requests are routed through the configured acquisition provider. Built on an async watch + notification model designed for LLM agents.
mcp-gateway required: This server must be deployed behind mcp-gateway, which handles authentication and injects
X-Authenticated-User+Authorizationheaders. Standalone OAuth is not supported. Migrating fromcopilot-review-mcp? See docs/architecture.md — Migration / Compatibility.
Features
- Async watch + notification based. Start a background watch with
start_copilot_review_watch, then track progress via the cheapget_copilot_review_watch_statusread andnotifications/resources/updatedevents. - GraphQL-based Copilot review request. Avoids the issue where REST
requested_reviewerssilently ignores bot actors. - Per-thread review operations. Reply, resolve, or reply+resolve individual threads using
PRRT_xxxnode IDs. - mcp-gateway integration for authentication. The gateway handles OAuth and injects verified identity headers.
- Stateful sessions.
Mcp-Session-Idis bound to a GitHub login; sessions are automatically pruned on idle timeout. - SQLite-persisted watch state. Active watches that survive a process restart are observable as
STALE.
Tools
| Tool | Description |
|---|---|
request_copilot_review | Request a Copilot review on a PR |
get_copilot_review_status | Fetch an instant snapshot from GitHub |
start_copilot_review_watch | Start a background watch (recommended entry point) |
get_copilot_review_watch_status | Cheap read of the current watch state |
list_copilot_review_watches | List your active/recent watches |
cancel_copilot_review_watch | Stop a watch |
get_pr_review_cycle_status | Overall review cycle status and next-action recommendation |
get_review_threads | List review threads (raw data; classification is left to the calling LLM) |
reply_to_review_thread | Post a reply to a thread |
resolve_review_thread | Mark a thread as resolved |
reply_and_resolve_review_thread | Reply then resolve in sequence |
wait_for_copilot_review | Legacy blocking wait (fallback) |
See docs/usage.md for setup and operation. Tool-level details are in docs/watch-tools.md and docs/skills/pr-review-cycle.md. For the architecture and responsibility boundaries with Thread Owl and mcp-resource-subscriber, see docs/architecture.md.
Quick Start (Docker + mcp-gateway)
This server requires mcp-gateway to handle authentication.
# Start review-raven (internal, not exposed directly)
docker run --rm -p 127.0.0.1:8083:8083 \
-e BIND_ADDR=0.0.0.0 \
-v review-raven-data:/data \
ghcr.io/scottlz0310/review-raven:latest
Configure mcp-gateway to proxy the internal address of this server as seen from the gateway (e.g., http://review-raven:8083 on a shared Docker network, or http://host.docker.internal:8083 on Docker Desktop). See mcp-gateway docs.
For stdio clients (Claude Desktop, etc.) use mcp-remote:
{
"mcpServers": {
"review-raven": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://your-gateway-url/mcp"]
}
}
}
See docs/usage.md for the full setup guide.
Environment Variables
| Variable | Required | Default | Description |
|---|---|---|---|
MCP_PORT | 8083 | Listen port | |
BIND_ADDR | 127.0.0.1 | Bind address. Use 0.0.0.0 in Docker so the container is reachable from mcp-gateway on the same network | |
LOG_LEVEL | info | debug / info / warn / error | |
SQLITE_PATH | /data/review-raven.db | Path to the watch-state database | |
IN_PROGRESS_THRESHOLD_SEC | 30 | Grace period after a review request before treating the review as in-progress (seconds) | |
MCP_SESSION_TIMEOUT_MIN | 0 | Idle timeout for Streamable HTTP sessions (minutes). After this period without any HTTP request from a client, the session is closed and subsequent requests with the stale Mcp-Session-Id get 404 session not found. The default 0 disables idle eviction so long-lived clients (Claude Code / IDE / mcp-gateway) do not hit the failure mode in #14. Trade-off: orphaned sessions (clients that disappear without sending DELETE) remain in memory until process shutdown — set a positive value (e.g. 1440 for 24h) if memory growth is a concern. | |
REVIEW_RAVEN_GATEWAY_INTERNAL_URL | (unset) | Phase B — Full URL of the mcp-gateway internal whoami endpoint (e.g. http://127.0.0.1:8080/internal/v1/whoami). Must be a loopback address. Set together with REVIEW_RAVEN_GATEWAY_INTERNAL_SECRET or leave both unset. | |
REVIEW_RAVEN_GATEWAY_INTERNAL_SECRET | (unset) | Phase B — Shared bearer secret for the gateway internal API. Must be set together with REVIEW_RAVEN_GATEWAY_INTERNAL_URL. |
Not supported (removed in pre-rename copilot-review-mcp lineage): GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET, BASE_URL, GITHUB_OAUTH_SCOPES, SESSION_TTL_MIN, TOKEN_CACHE_TTL_MIN, TOKEN_EXPIRES_IN_SEC, AUTH_MODE.
Local Development
Requires Go 1.26+.
# Run tests
go test ./...
# Build
go build -o bin/review-raven ./cmd/server
# Build Docker image
docker build -t review-raven:dev .
History
This repository is a split-out of services/review-raven/ from scottlz0310/Mcp-Docker. Git history was not migrated. Related PRs and Issues from Mcp-Docker (#47, #52, #53, #55–#58, #62, #63–#68, #74–#77, #92, etc.) are referenced in the documents under docs/.
License
MIT License — see LICENSE.