Memory Bank MCP MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Cinco ferramentas: memory_bank_read, memory_bank_write, memory_bank_update, list_projects, list_project_files
Isolamento de vários projetos — cada projeto tem sua própria pasta em MEMORY_BANK_ROOT
Prevenção de passagem de caminho integrada — com escopo definido para a raiz que você configura
Operações de tipo seguro com mensagens de erro explícitas
Funciona com qualquer cliente MCP; sem dependência de Cline

Demo ao vivo

Como fica na prática

memory-bank-mcp.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "memory-bank-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ],
      "env": {
        "MEMORY_BANK_ROOT": "/path/to/memory/banks"
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "memory-bank-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@allpepper/memory-bank-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "memory-bank-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@allpepper/memory-bank-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add memory-bank-mcp -- npx -y @allpepper/memory-bank-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Memory Bank MCP

Dê a um novo agente contexto instantâneo sobre um projeto de longa duração

👤 Equipes executando vários agentes na mesma base de código ⏱ ~10 min beginner

Quando usar: Um novo bate-papo precisa do mesmo histórico (convenções, decisões anteriores, bugs conhecidos) que seu último bate-papo já aprendeu.

Pré-requisitos

Banco de memória existente para este projeto — Preencha-o durante o trabalho normal com memory_bank_write

Fluxo

Liste os arquivos que o banco do projeto já possui

Chame list_project_files para project=acme-api.✓ Copiado

→ arquitetura.md, decisões.md, perguntas abertas.md, etc.
Carregue o subconjunto relevante

Leia Decisions.md e open-questions.md antes de iniciar a tarefa.✓ Copiado

→ O agente faz referência a decisões anteriores em vez de perguntar novamente

Resultado: Novas sessões começam quentes em vez de frias; você para de pagar o imposto de integração todas as vezes.

Armadilhas

Deixar o banco crescer e se tornar um arquivo gigante — Dividido por preocupação – decisões, arquitetura, perguntas abertas, runbook – para que o agente carregue apenas o que precisa

Combine com: codebase-memory

Versão da memória do seu agente no git como qualquer outro documento de projeto

👤 Equipes que desejam que a memória sobreviva entre máquinas e colaboradores ⏱ ~20 min intermediate

Quando usar: Você deseja que os arquivos de memória sejam revisados, diferenciados e compartilhados com colegas de equipe.

Pré-requisitos

Repo Git para hospedar o banco — git init dentro de MEMORY_BANK_ROOT ou uma subpasta do projeto

Fluxo

Faça do root um repositório

Transforme ~/ai-memory em um repositório git; adicione um .gitignore para qualquer coisa sensível.✓ Copiado

→ Estrutura padrão do repositório git
Deixe o agente atualizar a memória durante as sessões

Depois de corrigir o bug, chame memory_bank_update para registrar a causa raiz em bugs.md.✓ Copiado

→ Nova diferença pronta para commit
Comprometa-se e empurre

Revise a diferença de memória, confirme, empurre.✓ Copiado

→ Os colegas de equipe puxam e seus agentes compartilham imediatamente o contexto

Resultado: A memória do agente se torna um artefato de projeto de primeira classe.

Armadilhas

Cometer segredos que o agente anotou — Adicione um scanner de pré-confirmação (por exemplo, gileaks) antes de enviar o repositório de memória

Combine com: github · git

Combinações

Combine com outros MCPs para 10× de alavancagem

memory-bank-mcp + filesystem

Banco de memória mantém anotações do agente; sistema de arquivos lê o código ao qual se referem

Leia Decisions.md do banco de memória e abra os arquivos referenciados em src/.✓ Copiado

memory-bank-mcp + github

Após a fusão de um PR, registre o resultado no banco de memória do projeto

Resuma o PR nº 412 mesclado e atualize memory-bank/acme-api/decisions.md.✓ Copiado

memory-bank-mcp + codebase-memory

Duas camadas de memória complementares – memória gráfica de código + notas legíveis por humanos

Combine o gráfico de símbolos de memória de base de código com a narrativa em memory-bank/architecture.md.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
memory_bank_read	project: str, file: str	Extraia a memória existente antes de planejar
memory_bank_write	project: str, file: str, content: str	Crie um novo arquivo de memória
memory_bank_update	project: str, file: str, content: str	Modificar um arquivo de memória existente (falha se estiver faltando)
list_projects	(none)	Descubra quais projetos já possuem bancos de memória
list_project_files	project: str	Veja quais arquivos de memória estão disponíveis antes de ler

Custo e limites

O que custa rodar

Cota de API: Nenhuma API externa
Tokens por chamada: Depende do tamanho do arquivo; nota típica 200–2000 tokens
Monetário: Gratuito – executado localmente
Dica: Mantenha os arquivos de memória curtos e com escopo específico; carregar um arquivo de 50 KB desperdiça contexto em cada chamada.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Sem credenciais. O caminho MEMORY_BANK_ROOT é a única configuração.

Saída de dados: Nenhuma chamada de rede — as leituras e gravações permanecem no sistema de arquivos local em MEMORY_BANK_ROOT.

Não defina MEMORY_BANK_ROOT como sua raiz inicial ou do projeto – coloque-o em uma pasta dedicada para que os agentes não possam ler arquivos não relacionados.
Revise o que os agentes escrevem na memória antes de enviá-lo ao git; as transcrições do bate-papo podem incluir segredos que o agente viu anteriormente.

Solução de problemas

Erros comuns e correções

Erro: MEMORY_BANK_ROOT não está definido

Defina o env var na configuração do cliente MCP e reinicie o cliente.

Verificar: echo $MEMORY_BANK_ROOT

ENOENT ao ler um arquivo

Chame list_project_files primeiro — o nome do arquivo deve existir exatamente.

Verificar: ls $MEMORY_BANK_ROOT/<project>/

EACCES na gravação

Certifique-se de que o processo MCP tenha permissão de gravação em MEMORY_BANK_ROOT.

Verificar: touch $MEMORY_BANK_ROOT/.probe && rm $MEMORY_BANK_ROOT/.probe

Alternativas

Memory Bank MCP vs. outros

Alternativa	Quando usar	Troca
memory (official)	Você quer um gráfico de conhecimento, não notas baseadas em arquivo	O gráfico é estruturado, mas menos editável por humanos
memory-service	Você quer pesquisa semântica na memória	Configuração mais pesada; incorporações necessárias
Cline Memory Bank (inline)	Você só usa Cline e não precisa de compartilhamento entre IDE	Bloqueado em Cline

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills