MCP Memory Gateway: Um Servidor MCP para Memória Persistente no Claude Code

O MCP Memory Gateway é um servidor MCP construído especificamente para o Claude Code que lhe dá memória persistente entre sessões. O projeto aborda o problema em que o Claude Code perde todo o contexto entre sessões, exigindo que os usuários repitam instruções como "não faça push sem verificar os tópicos de revisão de PR" várias vezes.

Como Funciona

O sistema opera através de quatro componentes principais:

• Captura: Os usuários registram feedback estruturado quando o Claude Code faz algo errado (o que deu errado e o que mudar) ou quando faz algo certo.
• Promoção: Quando a mesma falha aparece 3+ vezes, ela se torna automaticamente uma regra de prevenção.
• Portão: As regras de prevenção se tornam ganchos PreToolUse. Antes que o Claude Code execute uma chamada de ferramenta, o mecanismo de portão verifica se ela corresponde a um padrão de falha conhecido. Se corresponder, a chamada é bloqueada com uma explicação do porquê e o que fazer em vez disso.
• Recuperação: No início da sessão, o contexto relevante de sessões anteriores é injetado para que o Claude Code tenha o histórico que de outra forma perderia.

Desenvolvimento com Claude Code

O desenvolvedor usou o Claude Code como ferramenta principal de desenvolvimento durante vários meses. O Claude Code esteve envolvido em quase todas as partes do projeto:

• Escreveu a lógica inicial do mecanismo de portão, incluindo o sistema de correspondência de padrões que compara chamadas de ferramentas com regras de falha armazenadas
• Gerou o sistema de validação de feedback que garante que as entradas estruturadas tenham o esquema correto antes de armazená-las
• Construiu a camada de integração do protocolo MCP — lidando com registro de ferramentas, roteamento de solicitações e formatação de respostas
• Diagnosticou e corrigiu um bug onde as regras de prevenção não eram acionadas em chamadas de ferramentas aninhadas, reescrevendo a lógica de correspondência para lidar com cadeias de ferramentas recursivas
• Usado diariamente para refatoração, escrita de testes e iteração no sistema de recuperação que seleciona qual contexto injetar no início da sessão

Começando

O núcleo é totalmente de código aberto e licenciado MIT sem limitações. A configuração pode ser feita com um comando:

npx mcp-memory-gateway init --agent claude-code

O projeto está disponível no GitHub em https://github.com/IgorGanapolsky/mcp-memory-gateway.