O que é codebase-memory-mcp?
O codebase-memory-mcp, da DeusData, analisa um repositório com 163 gramáticas do tree-sitter embutidas e o transforma em um grafo de conhecimento em SQLite com funções, classes, arquivos, imports, chamadas, rotas e fluxo de dados, guardado entre sessões em ~/.cache/codebase-memory-mcp. Desde a v0.12.0 o grafo também incorpora documentação em Markdown e PDF, registros de decisões de arquitetura, Dockerfiles, manifestos do Kubernetes, charts do Helm, Terraform e jobs de CI, de modo que um agente pode seguir um Service pelo seu workload e sua imagem até o programa que o contêiner executa. Uma passada Hybrid LSP refina as arestas de chamada com resolução de tipos para 11 famílias de linguagens, entre elas Python, TypeScript, Go, Java e Rust.
O servidor expõe 17 ferramentas MCP, entre elas search_graph (busca estrutural, BM25 e semântica com um modelo de embeddings compilado no binário), trace_path, detect_changes para o raio de impacto de um diff do git e query_graph, somente leitura e parecido com Cypher. O instalador configura 46 integrações com clientes, entre eles Claude Code, Codex, Gemini CLI, Cursor e OpenCode. Um visualizador opcional no navegador, o CBM Lens, está em beta aberto.
O repositório foi criado em fevereiro de 2026, usa licença MIT, é escrito em C e tem cerca de 48.500 estrelas e 4.000 forks. A versão mais recente é a v0.12.1, de 16 de outubro de 2026. O pacote do npm registrou cerca de 12.100 downloads e o do PyPI cerca de 2.100 na semana até 10 de novembro.
Como instalar codebase-memory-mcp
curl -fsSL https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bashcodebase-memory-mcp vale a pena?
O codebase-memory-mcp cobre mais de um sistema do que qualquer outro grafo de código desta categoria. Onde o CodeGraph e o GitNexus param nos arquivos-fonte, ele liga o código aos Dockerfiles, objetos do Kubernetes, charts do Helm, módulos do Terraform e etapas de CI que o constroem e implantam, então o trace_path responde a "o que implanta este serviço?" além de "quem chama esta função?". Essa amplitude vem sob MIT, algo que a licença não comercial do GitNexus não oferece.
Os números publicados são grandes, mas vêm dos autores. Um preprint no arXiv de março de 2026, assinado pelos mantenedores, relata uso de tokens 10 vezes menor e 2.1 vezes menos chamadas de ferramentas do que a exploração arquivo por arquivo em 31 repositórios. O README cronometra uma indexação completa do kernel do Linux, 28M linhas em 75K arquivos, em 3 minutos em um Apple M3 Pro, e consultas Cypher abaixo de 1 ms. Não encontramos nenhuma replicação independente.
Os padrões de privacidade são melhores que os dos rivais. O README diz que o binário não faz nenhuma requisição de rede por conta própria, não procura atualizações e não coleta telemetria, enquanto o CodeGraph e o CocoIndex Code enviam dados de uso a menos que você os desligue. A busca semântica roda com um modelo de embeddings compilado no binário, sem Ollama nem chave de API. As versões trazem proveniência SLSA Level 3, assinaturas cosign, checksums e varreduras do VirusTotal; o Microsoft Defender ainda sinaliza algumas compilações, o que o projeto documenta como falso positivo.
A instalação é mais pesada do que a lista de ferramentas sugere. O início rápido é um script de curl para bash, e os binários da v0.12.0 tinham de 331 a 335 MB, a ponto de quebrar os instaladores do npm, PyPI e Go até a v0.12.1. O instalador adiciona hooks por padrão; no Claude Code isso inclui um hook PreToolUse não bloqueante em Grep, Glob e Bash que injeta contexto do grafo, removível com install --no-hooks. O index_repository aceita qualquer caminho a menos que CBM_ALLOWED_ROOT esteja definido.
A maturidade é a verdadeira dúvida. Há cerca de 487 issues abertas, entre elas um relato de vazamento de memória aberto desde junho e outro de uso alto de CPU desde março, e só a v0.12.0 incorporou 231 pull requests. Um artefato de grafo compartilhado pela equipe é opcional, mas o README avisa que fazer commit de cada atualização fez o histórico de uma equipe crescer para cerca de 6 GB em 350 commits.
Onde ele se destaca
Um engenheiro de plataforma em uma empresa que roda seus serviços no Kubernetes
Descobrir a quais implantações e imagens chega uma mudança em uma biblioteca compartilhada
Indexe o monorepo com index_repository e peça ao agente para rodar detect_changes na branch e trace_path nos modos deploy e run. Ele segue o caminho Service, workload, imagem, Dockerfile e programa; valores do Helm em templates que ele não consegue resolver ficam de fora, então confirme as lacunas com check_index_coverage.
Uma equipe de C/C++ com uma suíte de testes de CI lenta
Rodar só os testes que uma pull request pode afetar
A camada experimental Smart CI combina alcance estático com cobertura por teste e volta para run_all quando faltam evidências. Ela só restringe código C/C++ com harnesses compatíveis; comece no modo sombra, apenas com relatório, como o README recomenda.
Uma gerente de engenharia em uma empresa regulada que leva agentes a toda a área técnica
Dar a todos contexto de grafo de código sem contrato com fornecedor nem dados saindo dos notebooks
Licença MIT, sem telemetria e sem serviço hospedado: não há nada a negociar. Defina CBM_ALLOWED_ROOT na configuração gerenciada para limitar a indexação e decida de antemão se mantém os hooks padrão ou instala com --no-hooks.
Antes de decidir
- Configuração
- Baixe com curl o script install.sh (ou install.ps1 no Windows), ou use npm, PyPI, Homebrew, AUR, Nix ou go install; também há um plugin para o Claude Code. O instalador detecta os clientes e grava a configuração MCP, skills, três perfis de agente e hooks; reinicie o agente e diga "Index this project". auto_index vem desligado por padrão.
- Integrações
- 17 ferramentas: index_repository, list_projects, delete_project, index_status, check_index_coverage, search_graph, trace_path, detect_changes, query_graph, get_graph_schema, compare_graphs, get_code_snippet, get_file_outline, get_architecture, search_code, manage_adr e ingest_traces. Nenhuma ferramenta edita o código-fonte: as gravações vão para o índice, seu documento ADR e, só com persistence: true, para um snapshot do grafo na pasta .codebase-memory do repositório.
- Dados e privacidade
- Índices e grafo ficam locais em ~/.cache/codebase-memory-mcp; o README diz que o binário não envia telemetria nem faz requisições de rede não solicitadas. O CBM Lens escuta em 127.0.0.1 só quando iniciado, e seu modelo opcional para o navegador é baixado do Hugging Face. Não há avisos de segurança publicados.
- Custo em escala
- Gratuito; os únicos custos são CPU, RAM e disco locais. A memória da indexação pode ser limitada com index_max_rss_mb ou CBM_MEM_BUDGET_MB. A economia aparece na conta do modelo, com menos leituras de arquivos por pergunta.
- Limites
- Só stdio; um transporte HTTP nativo é um pedido de recurso em aberto. Chamadas síncronas longas de indexação podem estourar os prazos do cliente, então repositórios grandes precisam do modo assíncrono. O Hybrid LSP cobre 11 famílias de linguagens; as demais recorrem à resolução textual. Todos os processos ativos precisam rodar exatamente a mesma compilação.
O que é bom
- O grafo abrange código, documentação, Docker, Kubernetes, Helm, Terraform e CI
- Licença MIT; sem telemetria nem chamadas de rede vindas do binário
- Consultas Cypher somente leitura e raio de impacto de diffs em 17 ferramentas
- Versões assinadas com proveniência SLSA Level 3
O que não é
- Cerca de 487 issues abertas, incluindo relatos de memória e CPU
- O instalador adiciona hooks às chamadas de ferramentas do agente por padrão
- Binários acima de 330 MB; início rápido por curl para bash
- A economia de tokens divulgada vem do estudo dos próprios mantenedores
Ideal para
Equipes cujos agentes precisam rastrear mudanças entre serviços e configuração de implantação, sob uma licença que a empresa aceite e sem que nada saia da máquina.
Alternativas ao codebase-memory-mcp
codebase-memory-mcp: perguntas frequentes
- codebase-memory-mcp vale a pena?
- O grafo de código mais amplo que você pode rodar sob MIT, de funções a charts do Helm e sem telemetria, desde que aceite os hooks que ele instala e uma fila de quase 500 issues abertas. Damos nota 4.2 de 5.
- Quanto custa codebase-memory-mcp?
- Gratuito e de código aberto (MIT). Sem plano hospedado, conta ou chave de API.
- Quais são as desvantagens de codebase-memory-mcp?
- Cerca de 487 issues abertas, incluindo relatos de memória e CPU; o instalador adiciona hooks às chamadas de ferramentas do agente por padrão; binários acima de 330 MB; início rápido por curl para bash; a economia de tokens divulgada vem do estudo dos próprios mantenedores.
- Para quem codebase-memory-mcp é indicado?
- Equipes cujos agentes precisam rastrear mudanças entre serviços e configuração de implantação, sob uma licença que a empresa aceite e sem que nada saia da máquina.
- Quanto custa codebase-memory-mcp para uma equipe ou em produção?
- Gratuito; os únicos custos são CPU, RAM e disco locais. A memória da indexação pode ser limitada com index_max_rss_mb ou CBM_MEM_BUDGET_MB. A economia aparece na conta do modelo, com menos leituras de arquivos por pergunta.
- codebase-memory-mcp é seguro para dados da empresa?
- Índices e grafo ficam locais em ~/.cache/codebase-memory-mcp; o README diz que o binário não envia telemetria nem faz requisições de rede não solicitadas. O CBM Lens escuta em 127.0.0.1 só quando iniciado, e seu modelo opcional para o navegador é baixado do Hugging Face. Não há avisos de segurança publicados.
- Quais são as melhores alternativas ao codebase-memory-mcp?
- As alternativas mais próximas que analisamos são CodeGraph, GitNexus, code-review-graph, Serena e CocoIndex Code.
Respostas verificadas em 11 de nov. de 2026.
Você faz o codebase-memory-mcp? Mostre esta nota no seu site
