IA by DNACX

#7 no GitHub · Entender o código

Como instalar e usar o Code Review Graph

Um servidor MCP que monta um mapa do seu código (funções, classes, quem chama quem) e entrega à IA só o trecho relevante de uma mudança. Assim o assistente lê apenas os arquivos que a mudança toca, em vez de reler o projeto inteiro.

Para quem
Quem programa com o Claude Code em projetos de código e quer revisões de mudanças que gastem menos tokens.
Estrelas (07/11/2026)
32.630, #7 no ranking
Licença
MIT
Repositório
tirth8205/code-review-graph

Passo a passo

Antes de começar: Python 3.10 ou mais novo; Um projeto de código na pasta onde você vai rodar os comandos (o README fala em árvore de trabalho Git ou SVN); Um assistente de código compatível. O README cita o Claude Code entre as ferramentas detectadas.

  1. Instale o pacote

    No terminal, cole o comando e aperte Enter. O README diz que dá para usar pipx no lugar do pip.

    Comando
    pip install code-review-graph

  2. Configure as suas ferramentas de IA

    Rode o comando dentro da pasta do projeto. Ele detecta quais ferramentas de código você tem instaladas e escreve a configuração do servidor MCP em cada uma. Onde a plataforma permite, também instala hooks e skills.

    Comando
    code-review-graph install

  3. Monte o mapa do código

    Este comando lê o projeto e cria o grafo. O README diz que o tempo cresce com o tamanho do repositório.

    Comando
    code-review-graph build

  4. Reinicie o Claude Code

    Feche e abra a ferramenta de novo para ela enxergar a configuração nova.

  5. Peça ao assistente para montar o grafo

    Abra o projeto no Claude Code e escreva o pedido abaixo. Depois disso, o README diz que hooks e o modo de observação mantêm o grafo atualizado.

Primeiro teste

Numa sessão com o servidor conectado, cole:

Primeiro teste
Build the code review graph for this project

O assistente cria o grafo do projeto. O README diz que, se alguns arquivos falharem na leitura, o resultado vem com status partial e nomeia esses arquivos.

Cuidados

  • O comando install escreve no seu computador: entrada do servidor MCP em cada ferramenta detectada, hooks e skills onde a plataforma permite, e instruções do grafo no arquivo de regras da plataforma.
  • Os hooks do Git (pre-commit, post-checkout, post-merge e post-rewrite) e o modo de observação atualizam o grafo sozinhos, conforme você trabalha.
  • O grafo fica guardado localmente: o README diz que é um arquivo SQLite na pasta .code-review-graph/, sem banco externo nem serviço em nuvem.
  • Em repositórios Git só os arquivos rastreados são indexados, e arquivos ignorados pelo Git ficam de fora. Para excluir arquivos rastreados, o README indica o arquivo .code-review-graphignore.
  • O README diz que não há telemetria e que as embeddings em nuvem são opcionais: são só ativadas se você escolher esse recurso, e há um aviso de saída de dados que a variável CRG_ACCEPT_CLOUD_EMBEDDINGS suprime.
  • O README lista limitações: em mudanças pequenas de um arquivo só, o contexto do grafo pode ser maior que a leitura simples do arquivo, e a análise de impacto é conservadora e pode apontar falsos positivos em projetos grandes.
  • No Windows, o README avisa para não usar um wrapper cmd /c na configuração do Claude Code e apontar o arquivo ~/.claude.json direto para o .exe.

Como desfazer

O README traz um comando de desinstalação que remove só o que a ferramenta criou e deixa outros servidores MCP, hooks e skills em paz. Dá para ver antes o que seria removido com a opção --dry-run.

Desfazer
code-review-graph uninstall --dry-run

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • Os números de redução de tokens e de tempo de build do README são medições do autor e não foram conferidos.
  • O README não informa custo. Ele cita provedores de embeddings pagos como opcionais, e o custo deles não é descrito.
  • O comando install não foi mostrado de forma específica para o Claude Code. O README diz que detecta as ferramentas instaladas, e a opção --platform com o nome da plataforma existe para configurar uma só.
  • Não está confirmado se o comando pip funciona do mesmo jeito no seu sistema; o README também cita pipx.

Dúvidas

Meu código é enviado para algum serviço?

O README diz que o grafo é guardado localmente e que não há telemetria. As embeddings em nuvem são opcionais.

Quais linguagens funcionam?

O README lista muitas, entre elas Python, JavaScript e TypeScript, Go, Rust, Java, C e C++, C#, Ruby, PHP, Kotlin e Swift, e permite adicionar linguagens por um arquivo languages.toml.

Preciso reconstruir o grafo a cada mudança?

Não, segundo o README. Os hooks, os hooks do Git e o modo de observação atualizam o grafo de forma incremental, relendo só os arquivos cujo hash mudou.

Serve para projetos pequenos?

O README inclui entre os casos em que não usar: repositórios pequenos, diferenças triviais em um arquivo e perguntas pontuais.

A DNACX usa o Code Review Graph?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próximo da lista

← #6 MCP for Blender · #8 Serena →

Ver os 15 MCPs

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de tirth8205/code-review-graph, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.