convez.ai
MCP ServerAutomaçãoAvançado
scottlz0310

Review Raven

scottlz0310/review-raven

Gerenciador de ciclos de revisão de PRs com watch assíncrono e notificações

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor 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-raven

1 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

Estrelas
1
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 2 dias
Versão
v0.12.0
Issues abertas
1
Contribuidores
2

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 + Authorization headers. Standalone OAuth is not supported. Migrating from copilot-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 cheap get_copilot_review_watch_status read and notifications/resources/updated events.
  • GraphQL-based Copilot review request. Avoids the issue where REST requested_reviewers silently ignores bot actors.
  • Per-thread review operations. Reply, resolve, or reply+resolve individual threads using PRRT_xxx node IDs.
  • mcp-gateway integration for authentication. The gateway handles OAuth and injects verified identity headers.
  • Stateful sessions. Mcp-Session-Id is 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

ToolDescription
request_copilot_reviewRequest a Copilot review on a PR
get_copilot_review_statusFetch an instant snapshot from GitHub
start_copilot_review_watchStart a background watch (recommended entry point)
get_copilot_review_watch_statusCheap read of the current watch state
list_copilot_review_watchesList your active/recent watches
cancel_copilot_review_watchStop a watch
get_pr_review_cycle_statusOverall review cycle status and next-action recommendation
get_review_threadsList review threads (raw data; classification is left to the calling LLM)
reply_to_review_threadPost a reply to a thread
resolve_review_threadMark a thread as resolved
reply_and_resolve_review_threadReply then resolve in sequence
wait_for_copilot_reviewLegacy 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

VariableRequiredDefaultDescription
MCP_PORT8083Listen port
BIND_ADDR127.0.0.1Bind address. Use 0.0.0.0 in Docker so the container is reachable from mcp-gateway on the same network
LOG_LEVELinfodebug / info / warn / error
SQLITE_PATH/data/review-raven.dbPath to the watch-state database
IN_PROGRESS_THRESHOLD_SEC30Grace period after a review request before treating the review as in-progress (seconds)
MCP_SESSION_TIMEOUT_MIN0Idle 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.

Ver o original no GitHub

Bom para

Relacionados