/ Directorio / Playground / Memory Bank MCP
← Todos los servidores ↗ GitHub
● Comunidad alioshr 🔑 Requiere tu clave

Memory Bank MCP

por alioshr · alioshr/memory-bank-mcp

Servidor de banco de memoria centralizado: mantenga los archivos de memoria Cline/Cursor/Claude en una carpeta, con alcance por proyecto, a salvo del cruce de rutas.

Memory-bank-mcp convierte el patrón Cline Memory Bank en un servidor MCP independiente. Apunte a un directorio raíz y cada proyecto obtendrá su propia carpeta de banco de memoria que los agentes pueden leer, escribir, actualizar y enumerar a través de cinco herramientas simples. Diseñado para que varios clientes (Claude Desktop, Cursor, Windsurf) compartan la misma memoria canónica; no necesita copias separadas por IDE.

▶ Ver demo 📦 Instalar 💡 Casos de uso

Por qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

memory-bank-mcp.replay ▶ listo
0/0

Instalar

Elige tu 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"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la 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"
      }
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "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"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json
{
  "context_servers": {
    "memory-bank-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@allpepper/memory-bank-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Memory Bank MCP

Comparta un banco de memoria entre Claude Desktop, Cursor y Windsurf

👤 Desarrolladores que alternan entre IDE y desean una única fuente de conocimiento del proyecto ⏱ ~15 min beginner

Cuándo usarlo: Utiliza más de un cliente de IA y sigue copiando las mismas notas sobre el proyecto.

Requisitos previos
  • Nodo 18+ — instalación nvm 18
  • Un directorio para guardar bancos de memoria. — mkdir -p ~/ai-memoria
Flujo
  1. Establezca MEMORY_BANK_ROOT en la configuración MCP de cada cliente
    Apunte cada cliente MCP a MEMORY_BANK_ROOT=~/ai-memory e instale @allpepper/memory-bank-mcp.✓ Copiado
    → Las herramientas Memory_bank_* aparecen en cada cliente.
  2. Crear el primer banco de proyectos
    Memory_bank_write project=acme-api file=architecture.md: resume los límites del servicio de este repositorio.✓ Copiado
    → El archivo aparece en ~/ai-memory/acme-api/architecture.md
  3. Leer de una cliente diferente
    En el cursor: memoria_bank_read proyecto=acme-api file=architecture.md✓ Copiado
    → Se devolvió el mismo contenido; las ediciones de cualquiera de los clientes se muestran instantáneamente

Resultado: Una carpeta de memoria compartida y versionable que cada IDE consulta automáticamente.

Errores comunes
  • Olvidar reiniciar el cliente MCP después de cambiar MEMORY_BANK_ROOT — Cerrar y volver a abrir el cliente; Las variables env solo se leen al inicio
Combinar con: filesystem · github

Ofrezca a un nuevo agente un contexto instantáneo sobre un proyecto de larga duración.

👤 Equipos que ejecutan varios agentes en la misma base de código ⏱ ~10 min beginner

Cuándo usarlo: Un chat nuevo necesita los mismos antecedentes (convenciones, decisiones pasadas, errores conocidos) que ya aprendió en el último chat.

Requisitos previos
  • Banco de memoria existente para este proyecto. — Rellénelo durante el trabajo normal con Memory_bank_write
Flujo
  1. Enumere los archivos que ya tiene el banco de proyectos
    Llame a list_project_files para project=acme-api.✓ Copiado
    → arquitectura.md, decisiones.md, preguntas-abiertas.md, etc.
  2. Cargue el subconjunto relevante
    Lea decision.md y open-questions.md antes de comenzar la tarea.✓ Copiado
    → La agente hace referencia a decisiones anteriores en lugar de volver a preguntar

Resultado: Las nuevas sesiones empiezan cálidas en lugar de frías; dejas de pagar el impuesto de incorporación cada vez.

Errores comunes
  • Dejar que el banco se convierta en un archivo gigante — Dividido por preocupación (decisiones, arquitectura, preguntas abiertas, runbook) para que el agente cargue solo lo que necesita
Combinar con: codebase-memory

Versione la memoria de su agente en git como cualquier otro documento de proyecto

👤 Equipos que quieren que la memoria sobreviva entre máquinas y contribuyentes. ⏱ ~20 min intermediate

Cuándo usarlo: Quiere que los archivos de memoria se revisen, se puedan diferenciar y se compartan con sus compañeros de equipo.

Requisitos previos
  • Repositorio de Git para alojar el banco. — git init dentro de MEMORY_BANK_ROOT o una subcarpeta del proyecto
Flujo
  1. Hacer de la raíz un repositorio
    Convierta ~/ai-memory en un repositorio de git; agregue un .gitignore para cualquier cosa sensible.✓ Copiado
    → Estructura de repositorio estándar de git
  2. Permitir que el agente actualice la memoria durante las sesiones.
    Después de corregir el error, llame a Memory_bank_update para registrar la causa raíz en bugs.md.✓ Copiado
    → Nueva diferencia lista para confirmar
  3. Comprométete y empuja
    Revise la diferencia de memoria, confirme, presione.✓ Copiado
    → Los compañeros de equipo tiran y sus agentes inmediatamente comparten el contexto.

Resultado: La memoria del agente se convierte en un artefacto de proyecto de primera clase.

Errores comunes
  • Cometiendo secretos que la agente anotó — Agregue un escáner de confirmación previa (por ejemplo, gitleaks) antes de enviar el repositorio de memoria
Combinar con: github · git

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

memory-bank-mcp + filesystem

El banco de memoria guarda las notas de los agentes; El sistema de archivos lee el código al que se refieren.

Lea decisiones.md del banco de memoria, luego abra los archivos a los que hace referencia en src/.✓ Copiado
memory-bank-mcp + github

Después de que un PR se fusiona, registre el resultado en el banco de memoria del proyecto.

Resuma el PR #412 fusionado y actualice Memory-bank/acme-api/decisions.md.✓ Copiado
memory-bank-mcp + codebase-memory

Dos capas de memoria complementarias: memoria de código-gráfico + notas legibles por humanos

Combine el gráfico de símbolos de memoria de base de código con la narrativa en Memory-bank/architecture.md.✓ Copiado

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
memory_bank_read project: str, file: str Extraiga la memoria existente antes de planificar 0
memory_bank_write project: str, file: str, content: str Crea un nuevo archivo de memoria 0
memory_bank_update project: str, file: str, content: str Modificar un archivo de memoria existente (falla si falta) 0
list_projects (none) Descubre qué proyectos ya tienen bancos de memoria 0
list_project_files project: str Vea qué archivos de memoria están disponibles antes de leer 0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
Sin API externa
Tokens por llamada
Depende del tamaño del archivo; billete típico de 200 a 2000 fichas
Monetario
Gratis: se ejecuta localmente
Consejo
Mantenga los archivos de memoria breves y temáticos; cargar un archivo de 50 KB desperdicia contexto en cada llamada.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Sin credenciales. La ruta MEMORY_BANK_ROOT es la única configuración.
Salida de datos: Sin llamadas de red: las lecturas y escrituras permanecen en el sistema de archivos local en MEMORY_BANK_ROOT.

Resolución de problemas

Errores comunes y soluciones

Error: MEMORY_BANK_ROOT no está configurada

Configure la var env en la configuración de su cliente MCP y reinicie el cliente.

Verificar: echo $MEMORY_BANK_ROOT
ENOENT al leer un archivo

Llame primero a list_project_files: el nombre del archivo debe existir exactamente.

Verificar: ls $MEMORY_BANK_ROOT/<project>/
EACCES en escritura

Asegúrese de que el proceso MCP tenga permiso de escritura en MEMORY_BANK_ROOT.

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

Alternativas

Memory Bank MCP vs otros

AlternativaCuándo usarlaContrapartida
memory (official)Quieres un gráfico de conocimiento, no notas basadas en archivosEl gráfico está estructurado pero es menos editable por humanos.
memory-serviceQuieres búsqueda semántica sobre la memoria.Configuración más pesada; incrustaciones requeridas
Cline Memory Bank (inline)Solo usas Cline y no necesitas compartir entre IDEBloqueado a Cline

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills