Memento v1.0: Servidor MCP de Memória Persistente para Claude Code com 17 Ferramentas

O Memento v1.0 é um servidor MCP de memória persistente para o Claude Code que dá aos agentes de IA de programação memória de longo prazo entre sessões. A ferramenta roda completamente localmente, sem dependências de nuvem, chaves de API ou telemetria.

Funcionalidades Principais

O servidor inclui 17 ferramentas MCP: salvar, recuperar, buscar, esquecer, listar, exportar, importar, ingerir, indexar, migrar, compactar, estatísticas, perfil, relacionados, início de sessão, resumo de sessão e saúde.

Capacidades de Busca

• Busca vetorial: Usa similaridade de cosseno com índice HNSW para encontrar memórias por significado
• Busca por palavras-chave: Implementação completa BM25 (mesmo algoritmo do Elasticsearch) para correspondência exata de termos
• Busca híbrida: Combina 70% vetorial + 30% pontuação BM25, que o criador usa diariamente

Gerenciamento Inteligente de Memória

• Detecção de contradições: Cria automaticamente relações de substituição quando você muda decisões (ex: "usamos PostgreSQL" → "mudamos do PostgreSQL para CockroachDB") e desprioriza informações antigas
• Pontuação de importância: Salvamentos explícitos > capturas automáticas, decisões > conversa, com decaimento exponencial de 347 dias para que o contexto recente apareça primeiro
• Grafo de conhecimento: Extrai caminhos de arquivos, funções, classes, pacotes, URLs e variáveis de ambiente de cada memória

Visualização e API

memento serve inicia um servidor local em localhost:7007 que fornece:

• Visualização de grafo direcionado por força D3.js com nós coloridos por tag e arestas mostrando relações
• API REST espelhando todas as 17 ferramentas

Funcionalidades de Produção

• Disjuntor de circuito para tolerância a falhas
• Log write-ahead para recuperação de falhas
• Cache LRU para embeddings

Integração com IDE e Navegador

• Suporte multi-IDE: Claude Code, Cursor, Windsurf, OpenCode com armazenamento de memória compartilhado entre todos os quatro
• Extensão Chrome: Clique com o botão direito em qualquer página ou seleção para salvá-la diretamente na memória

Dados de Uso

Durante o desenvolvimento do v1.0, o Memento capturou 2.191 memórias em 27 sessões: 1.905 de ganchos de captura automática, 206 de resumos de sessão e 79 salvamentos explícitos. Isso criou 53MB de contexto de engenharia pesquisável.

Configuração e Recursos

Comando de configuração: npx memento-memory setup

• GitHub: https://github.com/sanathshetty444/memento
• Documentação: https://sanathshetty444.github.io/memento/
• Artigo completo: https://medium.com/@sanathshetty444/it-remembered-9e7d10f444ff