Sobre o projeto

codebase-memory-mcp é um mecanismo de inteligência de código projetado para atender agentes de codificação de IA por meio do Model Context Protocol (MCP). Ele analisa uma base de código em um grafo de conhecimento persistente de funções, classes, cadeias de chamadas, rotas HTTP e links entre serviços, respondendo então a consultas estruturais nesse grafo. Características principais evidenciadas no README: - Indexação: análise de AST tree-sitter em 162 gramáticas vendored compiladas no binário. Um pipeline RAM-first usa compressão LZ4, SQLite em memória e correspondência de padrão Aho-Corasick. O README relata a indexação do kernel Linux (28M LOC, 75K arquivos) em cerca de 3 minutos. - LSP híbrido: implementação leve em C de algoritmos de resolução de tipo para Python, TypeScript/JavaScript/JSX/TSX, PHP, C#, Go, C, C++, Java, Kotlin, Rust e Perl, abrangendo vinculação de parâmetros, inferência de tipo de retorno, substituição genérica e padrões de resolução específicos de linguagem. - Superfície de consulta: 15 ferramentas MCP incluindo visão geral de arquitetura, rastreamento de grafo de chamadas, análise de impacto, detecção de código morto, consultas de grafo semelhantes a Cypher, busca semântica, busca full-text BM25 e busca de código. O README relata consultas estruturais de sub-milisegundo e uma redução de tokens em comparação com a exploração arquivo por arquivo. - Modelo de grafo: tipos de aresta como CALLS, IMPORTS, DEFINES, IMPLEMENTS, INHERITS, HTTP_CALLS, EMITS, LISTENS_ON, DATA_FLOWS, SIMILAR_TO e SEMANTICALLY_RELATED. Arestas CROSS_* entre repositórios ligam nós entre repositórios no mesmo armazenamento. - Infraestrutura como código: Dockerfiles, manifests do Kubernetes e overlays do Kustomize são indexados como nós de grafo com referências cruzadas. - Distribuição: um único executável nativo para macOS, Linux e Windows, sem runtime de linguagem, serviço hospedado ou chave de API necessários. Também disponível via npm, PyPI, Homebrew, Scoop, Winget, Chocolatey, AUR e go install. Todo o processamento é local. - Operação: um comando de instalação detecta e configura automaticamente os agentes de codificação suportados. Um daemon de coordenação compartilhado gerencia observadores em segundo plano, trabalhos de indexação e a UI opcional. Auto-index e auto-watch são configuráveis. Uma UI de visualização de grafo 3D embutida é servida em localhost:9749. - Compartilhamento em equipe: um snapshot SQLite opcional comprimido com zstd (.codebase-memory/graph.db.zst) pode ser commitado para que os colegas inicializem a partir do artefato e executem indexação incremental em vez de uma reindexação completa. O projeto não incorpora um LLM; o cliente MCP atua como camada de inteligência que traduz perguntas em linguagem natural em consultas de grafo. O README referencia um pré-print (arXiv:2603.27277) que descreve o design e os benchmarks, e documenta práticas de segurança incluindo processamento apenas local e verificação de artefatos de lançamento.