IA by DNACX

#3 no GitHub · Entender o código

Como instalar e usar o Codebase Memory

Um servidor MCP que lê o código do seu projeto e monta um mapa local das relações entre arquivos, funções, documentação e infraestrutura. A IA consulta esse mapa em vez de reler os arquivos toda hora.

Para quem
Quem tem um projeto de código grande ou desconhecido e quer que o assistente encontre trechos, siga chamadas e avalie o impacto de uma mudança.
Estrelas (07/11/2026)
48.287, #3 no ranking
Licença
MIT
Repositório
DeusData/codebase-memory-mcp

Passo a passo

Antes de começar: Um agente de código compatível (o README diz que o instalador detecta os clientes e cita Claude Code entre os suportados); macOS, Linux ou Windows; Acesso ao terminal (bash no macOS e Linux, PowerShell no Windows); Um projeto de código para indexar. O README diz que a indexação e as consultas não precisam de serviço hospedado nem de chave de API.

  1. Entenda o que o instalador faz antes de rodar

    O caminho principal do README é um script baixado da internet e executado na hora. O instalador escreve configuração nos agentes de código que você escolher. Se preferir olhar o script antes, o README mostra o caminho para Windows e a instalação manual por arquivo.

  2. Instale no macOS ou Linux

    Abra o terminal, cole o comando e aperte Enter. Ele baixa o script de instalação do GitHub e o executa.

    Comando
    curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash

  3. No Windows, baixe o instalador e inspecione antes

    O README manda baixar o instalador em arquivo, abrir para conferir, desbloquear e só então executar. Rode cada linha no PowerShell, uma de cada vez.

    Comando
    Invoke-WebRequest -Uri https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.ps1 -OutFile install.ps1

  4. Desbloqueie e execute no Windows

    Depois de conferir o arquivo, desbloqueie e rode. Se aparecer erro de política de execução, o README indica um comando de contorno apenas para aquela janela.

    Comando
    Unblock-File .\install.ps1

  5. Reinicie o agente de código

    Feche e abra de novo o Claude Code (ou o agente que você usa) para ele carregar o servidor recém-registrado.

  6. Peça para indexar o projeto

    Abra o agente dentro da pasta do projeto e escreva o pedido. É isso que cria o mapa local do código.

  7. Opcional: ligar a indexação automática

    Por padrão a indexação automática vem desligada. Se quiser que projetos novos sejam indexados na primeira conexão, rode o comando abaixo.

    Comando
    codebase-memory-mcp config set auto_index true

Primeiro teste

Numa sessão com o servidor conectado, cole:

Primeiro teste
Index this project

Segundo o README, depois de reiniciar o agente basta dizer isso e está pronto. O README não descreve a mensagem exata de retorno.

Cuidados

  • A instalação principal executa um script baixado da internet (curl ... | bash). Quem prefere conferir antes pode usar a instalação manual por arquivo descrita no README, ou, no Windows, o caminho em que o instalador é baixado e inspecionado.
  • O instalador grava configuração nos clientes de agente que você escolher. O README diz que a instalação também pode adicionar instruções, skills, perfis de agente e hooks (ganchos que rodam em eventos da sessão).
  • Os hooks vêm ligados por padrão. Para removê-los, o README indica 'codebase-memory-mcp install --no-hooks', que mantém o registro do MCP.
  • O README afirma que a análise do código e o armazenamento do grafo rodam na sua máquina e que a ferramenta não coleta telemetria.
  • O README avisa que o Microsoft Defender pode marcar o binário como falso positivo ('Trojan:Script/Wacatac.B!ml') e remete a um documento SECURITY.md com as evidências.
  • O visualizador CBM Lens está descrito como beta aberto (v0.0.1) e pode baixar um modelo para IA no navegador depois de habilitado.

Como desfazer

O README tem um comando de remoção. Ele apaga as entradas de configuração dos agentes, skills, hooks, instruções e o binário instalado. Os índices dos projetos são listados e mantidos por padrão.

Desfazer
codebase-memory-mcp uninstall

O que o README não confirma

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

  • Se o instalador reconhece o Claude Code na sua máquina e o que exatamente ele grava na configuração dele.
  • Quanto tempo leva e quanto espaço ocupa o índice de um projeto grande.
  • A versão atual do instalador e do CBM Lens (o README chama o visualizador de beta).
  • Se o seu antivírus vai bloquear o binário.

Dúvidas

Preciso de chave de API ou de um serviço na nuvem?

O README diz que a indexação e as consultas ao grafo não precisam de serviço hospedado nem de chave de API.

Meu código sai do meu computador?

O README diz que a análise do código e o armazenamento do grafo rodam na sua máquina. Ele cita como exceção opcional o download de um modelo no CBM Lens, com a inferência no próprio aparelho.

Como atualizo?

O README manda rodar de novo o script de instalação, que é idempotente. Se você instalou por npm ou pip, atualize pelo gerenciador de pacotes.

O que acontece com o mapa do código se eu desinstalar?

Por padrão os índices são mantidos. Só são apagados se você pedir explicitamente com a opção --delete-indexes.

A DNACX usa o Codebase Memory?

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

← #2 Chrome DevTools MCP · #4 Playwright MCP →

Ver os 15 MCPs

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