Memory Bank MCP Server

Servidor MCP del banco de memoria

Una implementación de servidor de Protocolo de Contexto de Modelo (MCP) para la gestión remota de bancos de memoria, inspirado en Cline Memory Bank .

Descripción general

El servidor MCP del banco de memoria transforma los bancos de memoria tradicionales basados en archivos en un servicio centralizado que:

• Proporciona acceso remoto a los archivos del banco de memoria a través del protocolo MCP
• Permite la gestión de bancos de memoria de múltiples proyectos
• Mantiene la estructura y validación de archivos consistente
• Garantiza un aislamiento adecuado entre los bancos de memoria del proyecto.

Características

• Soporte multiproyecto
  • Directorios específicos del proyecto
  • Cumplimiento de la estructura de archivos
  • Prevención de recorrido de ruta
  • Capacidades de listado de proyectos
  • Listado de archivos por proyecto
• Accesibilidad remota
  • Implementación completa del protocolo MCP
  • Operaciones con seguridad de tipos
  • Manejo adecuado de errores
  • Seguridad mediante el aislamiento del proyecto
• Operaciones principales
  • Leer/escribir/actualizar archivos del banco de memoria
  • Lista de proyectos disponibles
  • Listar archivos dentro de los proyectos
  • Validación de la existencia del proyecto
  • Operaciones seguras de solo lectura

Instalación

Para instalar Memory Bank Server para Claude Desktop automáticamente a través de Smithery :

Esto configurará automáticamente el servidor MCP. También puede configurarlo manualmente, como se describe en la sección "Configuración" a continuación.

Inicio rápido

1. Configure el servidor MCP en su configuración (consulte la sección Configuración a continuación)
2. Comience a utilizar las herramientas del banco de memoria en su asistente de IA

Configuración

El servidor MCP del banco de memoria debe configurarse en el archivo de configuración de Cline MCP. La ubicación depende de la configuración:

• Para la extensión Cline: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Para la extensión Roo Code VS Code: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
• Para la aplicación de escritorio de Claude: ~/Library/Application Support/Claude/claude_desktop_config.json

Agregue la siguiente configuración a la configuración de su MCP:

Detalles de configuración

• MEMORY_BANK_ROOT : Directorio donde se almacenarán los bancos de memoria del proyecto (por ejemplo, /path/to/memory-bank )
• disabled : establezca en false para habilitar el servidor
• autoApprove : Lista de operaciones que no requieren la aprobación explícita del usuario:
  • memory_bank_read : Leer archivos del banco de memoria
  • memory_bank_write : Crea nuevos archivos de banco de memoria
  • memory_bank_update : Actualizar los archivos del banco de memoria existentes
  • list_projects : Lista de proyectos disponibles
  • list_project_files : Lista los archivos dentro de un proyecto

Para el cursor

Para Cursor, abra configuración -> características -> agregar servidor MCP -> agregue lo siguiente:

Instrucciones de IA personalizadas

Esta sección contiene las instrucciones que deben pegarse en las instrucciones personalizadas de IA, ya sea para Cline, Claude, Cursor o cualquier otro cliente MCP. Debe copiar y pegar estas reglas. Para obtener más información, consulte custom-instructions.md , que contiene estas reglas.

Desarrollo

Comandos básicos de desarrollo:

Ejecutando con Docker

1. Construya la imagen de Docker:
   docker build -t memory-bank-mcp:local .
2. Ejecute el contenedor Docker para realizar pruebas:
   docker run -i --rm \ -e MEMORY_BANK_ROOT="/mnt/memory_bank" \ -v /path/to/memory-bank:/mnt/memory_bank \ --entrypoint /bin/sh \ memory-bank-mcp:local \ -c "ls -la /mnt/memory_bank"
3. Agregar configuración MCP, ejemplo para código Roo:
   "allpepper-memory-bank": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "MEMORY_BANK_ROOT", "-v", "/path/to/memory-bank:/mnt/memory_bank", "memory-bank-mcp:local" ], "env": { "MEMORY_BANK_ROOT": "/mnt/memory_bank" }, "disabled": false, "alwaysAllow": [ "list_projects", "list_project_files", "memory_bank_read", "memory_bank_update", "memory_bank_write" ] }

Contribuyendo

¡Agradecemos sus contribuciones! Siga estos pasos:

1. Bifurcar el repositorio
2. Crear una rama de características ( git checkout -b feature/amazing-feature )
3. Confirme sus cambios ( git commit -m 'Add amazing feature' )
4. Empujar a la rama ( git push origin feature/amazing-feature )
5. Abrir una solicitud de extracción

Directrices de desarrollo

• Utilice TypeScript para todo el código nuevo
• Mantener la seguridad de tipos en todo el código base
• Agregar pruebas para nuevas funciones
• Actualice la documentación según sea necesario
• Seguir el estilo y los patrones de código existentes

Pruebas

• Escribir pruebas unitarias para nuevas funciones
• Incluir pruebas de escenarios multiproyecto
• Pruebe los casos de error a fondo
• Validar restricciones de tipo
• Simular adecuadamente las operaciones del sistema de archivos

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

Este proyecto implementa el concepto de banco de memoria originalmente documentado en Cline Memory Bank , ampliándolo con capacidades remotas y soporte multiproyecto.