O que é MCP Memory Keeper?
O MCP Memory Keeper guarda o que um agente de programação está fazendo como itens de contexto com chave (uma tarefa, uma decisão, uma nota de progresso), com categoria, prioridade e canal, em um banco SQLite local em ~/mcp-data/memory-keeper/context.db. Checkpoints nomeados registram esses itens, conteúdos de arquivos em cache e o status do git, e o context_restore_checkpoint os traz de volta depois que o Claude Code compacta ou reinicia. Por padrão, os canais derivam do branch do git, então feature/auth-system vira um canal de no máximo 20 caracteres.
O servidor expõe 38 ferramentas via stdio por padrão, de context_save, context_get e context_search a ramificação de sessões, entradas de diário, um grafo de conhecimento e uma ferramenta context_git_commit. Uma variável TOOL_PROFILE reduz isso a 8 (minimal) ou 22 (standard). A instalação é claude mcp add memory-keeper npx mcp-memory-keeper; não há conta nem chave envolvidas.
O repositório foi criado em junho de 2025 por Mark Kreyman, tem licença MIT e cerca de 136 estrelas, com quase todos os commits de um único mantenedor. A versão mais recente no npm é a 0.14.1, de 2 de setembro de 2026 (os releases do GitHub param na v0.12.1), e o pacote registrou 140 downloads na semana até 22 de outubro. Ele não está listado no registro oficial de MCP.
Como instalar MCP Memory Keeper
claude mcp add memory-keeper npx mcp-memory-keeperMCP Memory Keeper vale a pena?
O Memory Keeper é construído em torno de um problema real das sessões longas de agentes: quando a janela de contexto é compactada, decisões e planos pela metade desaparecem. Sua resposta é deliberada, não automática. O próprio fluxo do README manda você pedir ao Claude que salve um checkpoint quando a conversa fica longa e que o restaure pela chave depois do reset; nada se conecta à compactação por você, e a recuperação depende de instruções no CLAUDE.md ou de um comando personalizado.
A lista de ferramentas é o principal custo. O perfil full padrão lista 38 ferramentas, cada uma com um esquema que o modelo lê a cada turno, para um trabalho que o servidor de memória de referência cobre com nove. O mantenedor reconhece isso com os perfis: o minimal mantém 8 (sessões, save, get, search, status e as duas ferramentas de checkpoint), e é por ali que a maioria das pessoas deveria começar. A versão 0.12.2 também corrigiu o perfil full quebrando provedores compatíveis com a OpenAI, um sinal de quanto a superfície se espalhou.
Alguns recursos são mais leves do que os nomes sugerem. O context_semantic_search não usa um modelo de linguagem: no código-fonte, ele aplica hash a trigramas de caracteres e palavras em um vetor de 384 números e compara esses vetores, então encontra grafias parecidas, não significados. As ferramentas de grafo de conhecimento e de múltiplos agentes rodam localmente sobre o mesmo texto salvo. O armazenamento é mais sólido: SQLite em modo WAL, caminho absoluto para o banco desde a 0.12.x e importação e exportação restritas a um diretório.
Dois pontos de segurança merecem atenção. O context_git_commit roda git add . e faz commit de tudo no diretório do projeto, então um agente pode preparar arquivos que você não pretendia commitar; deixe-o fora do seu perfil, a menos que queira isso. E a versão 0.13.0 (junho de 2026) corrigiu o context_import lendo qualquer arquivo que o servidor alcançasse, uma brecha que um agente com prompt injetado poderia ter usado para puxar segredos para a memória. A correção está feita, mas uma issue aberta ainda pede ao mantenedor que ative o relato privado de vulnerabilidades.
Em comparação com o servidor de memória de referência, a troca é estrutura por peso. O Memory dá a você um único arquivo JSONL legível e um grafo de entidades; o Memory Keeper dá categorias, prioridades, canais que acompanham o branch e checkpoints em um banco que você consulta com sqlite3. Com cerca de 140 downloads semanais no npm e um mantenedor, é um projeto pequeno, com releases ativos até setembro de 2026.
Onde ele se destaca
Um desenvolvedor solo fazendo uma refatoração de vários dias no Claude Code
Retomar de onde o agente parou depois de uma compactação ou reinício
Rode com TOOL_PROFILE=minimal, adicione uma regra no CLAUDE.md para salvar decisões e progresso e peça um context_checkpoint antes que a janela encha. Depois do reset, o context_restore_checkpoint devolve os itens salvos. É gratuito; o custo é lembrar de pedir.
Uma desenvolvedora rodando duas sessões do Claude Code em paralelo, uma pesquisando e outra implementando
Deixar uma sessão passar descobertas para a outra
As duas apontam para o mesmo DATA_DIR; por padrão, os itens ficam visíveis entre sessões, e um canal compartilhado mantém a passagem em um só tema. Não há controle de acesso entre as sessões, então tudo o que uma salva a outra pode ler.
Um líder de engenharia que aprova servidores MCP para uma equipe de 20 pessoas
Decidir se a equipe pode instalá-lo nos laptops de trabalho
Os dados ficam em um arquivo SQLite local e o código não faz chamadas de rede próprias, então não há operador de dados a avaliar. Os pontos a verificar são a ferramenta de commit no git (exclua-a com um perfil personalizado em ~/.mcp-memory-keeper/config.json), versões anteriores à 0.13.0 com o bug de leitura de arquivos no import e um projeto de um só mantenedor sem canal privado de divulgação.
Antes de decidir
- Configuração
- claude mcp add memory-keeper npx mcp-memory-keeper, ou o trecho npx na configuração do Claude Desktop; o README fala em menos de 30 segundos. Os dados vão para ~/mcp-data/memory-keeper/, a menos que DATA_DIR esteja definido. Quem atualiza de versões anteriores à 0.12.x precisa mover o context.db do antigo diretório de trabalho.
- Integrações
- 38 ferramentas por padrão, todas chamadas context_*: context_session_start, context_save, context_get, context_search, context_checkpoint, context_restore_checkpoint, context_prepare_compaction, context_export, context_import e outras. A maioria grava no banco; o context_git_commit grava no seu repositório. Os exemplos do README as prefixam com mcp_, que não é o nome registrado.
- Dados e privacidade
- Tudo fica em um banco SQLite mais um diretório de exportações. Os itens salvos são compartilhados entre sessões por padrão. Tudo o que o agente lê, incluindo texto injetado de uma página da web ou de um arquivo, pode ser salvo e reproduzido em sessões posteriores. A versão 0.13.0 corrigiu uma leitura arbitrária de arquivos locais via context_import (#35).
- Custo em escala
- Gratuito, sem limites de requisição. O custo real é o contexto: a lista completa de ferramentas a cada turno e respostas limitadas a 25.000 tokens por padrão (MCP_MAX_TOKENS), que um context_get grande pode preencher.
- Limites
- Só stdio, um usuário. Sem checkpoint automático na compactação; é preciso avisar o agente. A busca é por texto e por trigramas. O módulo nativo better-sqlite3 falhava ao carregar após atualizações do Node até a 0.14.1, e o README lista políticas de retenção e suporte a vários usuários como trabalho futuro.
O que é bom
- Checkpoints capturam itens, arquivos em cache e status do git juntos
- Os canais seguem o branch do git automaticamente
- Perfis de ferramentas reduzem 38 ferramentas a 8 ou 22
- SQLite local; sem conta, chave ou serviço de rede
O que não é
- 38 ferramentas por padrão incham cada prompt
- O context_git_commit prepara e faz commit do diretório inteiro do projeto
- A busca "semântica" usa trigramas com hash, não embeddings
- Um único mantenedor; cerca de 140 downloads semanais no npm
Ideal para
Usuários do Claude Code que fazem sessões longas e estão dispostos a dizer ao agente quando criar e restaurar checkpoints.
Alternativas ao MCP Memory Keeper
MCP Memory Keeper: perguntas frequentes
- MCP Memory Keeper vale a pena?
- Uma resposta bem pensada à perda de trabalho na compactação, embalada em 38 ferramentas e em um comando de commit que a maioria dos usuários deveria desligar. Damos nota 3.4 de 5.
- Quanto custa MCP Memory Keeper?
- Gratuito e com licença MIT.
- Quais são as desvantagens de MCP Memory Keeper?
- 38 ferramentas por padrão incham cada prompt; o context_git_commit prepara e faz commit do diretório inteiro do projeto; a busca "semântica" usa trigramas com hash, não embeddings; um único mantenedor; cerca de 140 downloads semanais no npm.
- Para quem MCP Memory Keeper é indicado?
- Usuários do Claude Code que fazem sessões longas e estão dispostos a dizer ao agente quando criar e restaurar checkpoints.
- Quanto custa MCP Memory Keeper para uma equipe ou em produção?
- Gratuito, sem limites de requisição. O custo real é o contexto: a lista completa de ferramentas a cada turno e respostas limitadas a 25.000 tokens por padrão (MCP_MAX_TOKENS), que um context_get grande pode preencher.
- MCP Memory Keeper é seguro para dados da empresa?
- Tudo fica em um banco SQLite mais um diretório de exportações. Os itens salvos são compartilhados entre sessões por padrão. Tudo o que o agente lê, incluindo texto injetado de uma página da web ou de um arquivo, pode ser salvo e reproduzido em sessões posteriores. A versão 0.13.0 corrigiu uma leitura arbitrária de arquivos locais via context_import (#35).
- Quais são as melhores alternativas ao MCP Memory Keeper?
- As alternativas mais próximas que analisamos são Memory (reference server) e Project RAG.
Respostas verificadas em 26 de out. de 2026.