Repolode
Enviar
DeusData

DeusData/codebase-memory-mcp

Servidor MCP que indexa código, documentação e infraestrutura em um grafo de conhecimento local para que agentes de programação com IA consultem a estrutura sem reler arquivos.

Ver no GitHubSite
Estrelas
47,045
Forks
3,863
Issues abertas
622
Último commit
há 3 horas

O que é?

codebase-memory-mcp é um servidor MCP nativo em C que cria um grafo de conhecimento local e persistente a partir de um repositório. Ele analisa o código-fonte com gramáticas tree-sitter incluídas no projeto, conecta símbolos por meio de chamadas, imports e herança e os relaciona à documentação em Markdown e PDF, além de configurações de Docker, Kubernetes, Helm, Terraform, Ansible e CI. Assim, agentes de programação podem consultar quem chama uma função, dependências, impacto de mudanças ou caminhos de implantação usando as 17 ferramentas MCP, ou consultar o grafo diretamente pela CLI.

A indexação e as consultas são executadas inteiramente na máquina local, sem exigir serviço hospedado ou chave de API. A busca semântica incluída usa um modelo de embeddings compilado no binário. O instalador configura clientes de agentes compatíveis, como Claude Code, Codex, Cursor e Windsurf, adicionando instruções, skills e hooks quando o cliente oferece suporte.

CBM Lens é uma interface opcional para navegador, em beta aberto, que visualiza o grafo como mapas de arquitetura, uma visualização 3D do grafo de chamadas e leitores de código-fonte com diagnósticos de cobertura. Também inclui um chat local que responde a perguntas sobre o código selecionado usando um modelo executado no dispositivo.

Recursos principais

  • 01Oferece 17 ferramentas MCP para busca estrutural, rastreamento de chamadas, resumos de arquitetura e análise do impacto de mudanças.
  • 02Analisa diversas linguagens com gramáticas tree-sitter incluídas no projeto e resolve chamadas entre arquivos.
  • 03Relaciona documentação em Markdown, PDF e ADR aos símbolos do código que ela menciona.
  • 04Mapeia as relações de Docker, Kubernetes, Helm, Terraform e Ansible com o código-fonte.
  • 05Executa buscas semânticas, BM25 e estruturais sem API ou serviço externo.
  • 06Instala configurações MCP e skills de agentes para 45 integrações de clientes compatíveis.

Casos de uso

  • Ajudar um agente de programação com IA a navegar por uma base de código grande e desconhecida sem precisar reler muitos arquivos.
  • Rastrear quais serviços e imagens são afetados por uma mudança em Kubernetes ou Terraform.
  • Estimar quais símbolos e testes podem ser afetados por um conjunto de mudanças ainda não commitadas.
  • Explorar visualmente a arquitetura de um repositório pela interface CBM Lens.

Início rápido

  1. 1

    Execute o script oficial de instalação para macOS ou Linux indicado no README

  2. 2

    Reinicie seu agente de programação

  3. 3

    Peça ao agente para indexar o projeto

  4. 4

    Se quiser, inicie o CBM Lens, o complemento visual

    codebase-memory-mcp daemon start --open --port=9749

Antes de usar

  • O CBM Lens, complemento visual, está em beta aberto (v0.0.1).
  • Em algumas configurações, a instalação no Windows exige uma solução alternativa para a política de execução do PowerShell.
  • O Microsoft Defender pode sinalizar por engano o binário da versão para Windows.

Tópicos

#mcp#code-intelligence#knowledge-graph#ai-agents#code-analysis#tree-sitter#static-analysis#aider#ast#claude-code

Perguntas frequentes

O que é codebase-memory-mcp?
Servidor MCP que indexa código, documentação e infraestrutura em um grafo de conhecimento local para que agentes de programação com IA consultem a estrutura sem reler arquivos. codebase-memory-mcp é um servidor MCP nativo em C que cria um grafo de conhecimento local e persistente a partir de um repositório. Ele analisa o código-fonte com gramáticas tree-sitter incluídas no projeto, conecta símbolos por meio de chamadas, imports e herança e os relaciona à documentação em Markdown e PDF, além de configurações de Docker, Kubernetes, Helm, Terraform, Ansible e CI. Assim, agentes de programação podem consultar quem chama uma função, dependências, impacto de mudanças ou caminhos de implantação usando as 17 ferramentas MCP, ou consultar o grafo diretamente pela CLI.
codebase-memory-mcp é gratuito? Qual é a licença?
codebase-memory-mcp é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
codebase-memory-mcp ainda é mantido?
Manutenção ativa. O último commit de codebase-memory-mcp foi em 21 de out. de 2026.
Para que posso usar codebase-memory-mcp?
Ajudar um agente de programação com IA a navegar por uma base de código grande e desconhecida sem precisar reler muitos arquivos. Rastrear quais serviços e imagens são afetados por uma mudança em Kubernetes ou Terraform. Estimar quais símbolos e testes podem ser afetados por um conjunto de mudanças ainda não commitadas. Explorar visualmente a arquitetura de um repositório pela interface CBM Lens.
Como instalar codebase-memory-mcp?
Execute o script oficial de instalação para macOS ou Linux indicado no README Reinicie seu agente de programação Peça ao agente para indexar o projeto Se quiser, inicie o CBM Lens, o complemento visual: codebase-memory-mcp daemon start --open --port=9749
Onde consigo codebase-memory-mcp?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/DeusData/codebase-memory-mcp

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados