Claude Memory MCP Server

Servidor MCP de Memoria para Claude

Una implementación de servidor MCP (Protocolo de Contexto de Modelo) que proporciona capacidades de memoria persistente para Modelos de Lenguaje de Gran Escala, diseñado específicamente para integrarse con la aplicación de escritorio de Claude.

Descripción General

Este proyecto implementa técnicas óptimas de memoria basadas en una investigación exhaustiva de los enfoques actuales en el campo. Proporciona una forma estandarizada para que Claude mantenga memoria persistente a través de conversaciones y sesiones.

Características

• Arquitectura de Memoria por Niveles: Niveles de memoria a corto plazo, largo plazo y de archivo
• Múltiples Tipos de Memoria: Soporte para conversaciones, conocimiento, entidades y reflexiones
• Búsqueda Semántica: Recupera memorias basadas en similitud semántica
• Gestión Automática de Memoria: Captura inteligente de memoria sin comandos explícitos
• Consolidación de Memoria: Consolidación automática de memorias a corto plazo en memoria a largo plazo
• Gestión de Memoria: Retención y olvido de memoria basados en importancia
• Integración con Claude: Integración lista para usar con la aplicación de escritorio de Claude
• Soporte de Protocolo MCP: Compatible con el Protocolo de Contexto de Modelo
• Soporte Docker: Implementación fácil usando contenedores Docker

Inicio Rápido

Opción 1: Usando Docker (Recomendado)

# Clone the repository
git clone https://github.com/WhenMoon-afk/claude-memory-mcp.git
cd claude-memory-mcp

# Start with Docker Compose
docker-compose up -d

Configure Claude Desktop para usar el servidor MCP contenerizado (consulte la Guía de Uso de Docker para más detalles).

Opción 2: Instalación Estándar

1. Requisitos previos:

   • Python 3.8-3.12
   • Gestor de paquetes pip

2. Instalación:

   # Clone the repository
   git clone https://github.com/WhenMoon-afk/claude-memory-mcp.git
   cd claude-memory-mcp
   
   # Install dependencies
   pip install -r requirements.txt
   
   # Run setup script
   chmod +x setup.sh
   ./setup.sh
   

3. Integración con Claude Desktop:

   Agregue lo siguiente a su archivo de configuración de Claude:

   {
     "mcpServers": {
       "memory": {
         "command": "python",
         "args": ["-m", "memory_mcp"],
         "env": {
           "MEMORY_FILE_PATH": "/path/to/your/memory.json"
         }
       }
     }
   }
   

Usando Memoria con Claude

El Servidor MCP de Memoria permite a Claude recordar información a través de conversaciones sin requerir comandos explícitos.

1. Memoria Automática: Claude automáticamente:

   • Recordará detalles importantes que comparta
   • Almacenará preferencias y hechos del usuario
   • Recuperará información relevante cuando sea necesario

2. Recuperación de Memoria: Para ver lo que Claude recuerda, simplemente pregunte:

   • "¿Qué recuerdas sobre mí?"
   • "¿Qué sabes sobre mis preferencias?"

3. Prompt del Sistema: Para un uso óptimo de la memoria, agregue esto al prompt del sistema de Claude:

   This Claude instance has been enhanced with persistent memory capabilities.
   Claude will automatically remember important details about you across
   conversations and recall them when relevant, without needing explicit commands.
   

Consulte la Guía de Usuario para instrucciones detalladas de uso y ejemplos.

Documentación

• Guía de Usuario
• Guía de Uso de Docker
• Guía de Compatibilidad
• Arquitectura
• Guía de Integración con Claude

Ejemplos

El directorio examples contiene scripts que demuestran cómo interactuar con el Servidor MCP de Memoria:

• store_memory_example.py: Ejemplo de almacenamiento de una memoria
• retrieve_memory_example.py: Ejemplo de recuperación de memorias

Solución de Problemas

Si encuentra problemas:

1. Consulte la Guía de Compatibilidad para requisitos de dependencias
2. Asegúrese de que su versión de Python sea 3.8-3.12
3. Para problemas con NumPy, use: pip install "numpy>=1.20.0,<2.0.0"
4. Intente usar Docker para una implementación simplificada

Contribuciones

¡Las contribuciones son bienvenidas! No dude en enviar una Solicitud de Extracción (Pull Request).

Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulte el archivo LICENCIA para más detalles.