Servidor MCP de memoria Claude

Una implementación de servidor MCP (Protocolo de contexto de modelo) que proporciona capacidades de memoria persistente para modelos de lenguaje grandes, diseñado específicamente para integrarse con la aplicación de escritorio Claude.

Descripción general

Este proyecto implementa técnicas de memoria óptima basadas en una investigación exhaustiva de los enfoques actuales en el campo. Proporciona un método estandarizado para que Claude mantenga una memoria persistente a lo largo de conversaciones y sesiones.

Características

• Arquitectura de memoria por niveles : niveles de memoria a corto, largo plazo y de archivo

• Múltiples tipos de memoria : soporte para conversaciones, conocimiento, entidades y reflexiones

• Búsqueda semántica : recupera recuerdos basándose en la similitud semántica

• Gestión automática de memoria : captura de memoria inteligente sin comandos explícitos

• Consolidación de la memoria : consolidación automática de recuerdos a corto plazo en memoria a largo plazo

• Gestión de la memoria : retención y olvido de la memoria basados en la importancia

• Integración de Claude : Integración lista para usar con la aplicación de escritorio de Claude

• Compatibilidad con el protocolo MCP : compatible con el protocolo de contexto de modelo

• Compatibilidad con Docker : Implementación sencilla mediante contenedores Docker

Inicio rápido

Opción 1: Usar Docker (recomendado)

Configure Claude Desktop para utilizar el servidor MCP en contenedor (consulte la Guía de uso de Docker para obtener más detalles).

Opción 2: Instalación estándar

1. Prerrequisitos :

   • 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 de escritorio de Claude :

   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 la memoria con Claude

El servidor de memoria MCP permite a Claude recordar información en las conversaciones sin necesidad de comandos explícitos.

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

   • Recuerda los detalles importantes que compartes

   • Almacenar preferencias y datos del usuario

   • Recordar información relevante cuando sea necesario

2. Recuerdo de la memoria : para ver lo que recuerda Claude, simplemente pregúntele:

   • ¿Qué recuerdas de mí?

   • ¿Qué sabes de mis preferencias?

3. Aviso del sistema : para un uso óptimo de la memoria, agregue lo siguiente al aviso 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 del usuario para obtener instrucciones de uso detalladas y ejemplos.

Documentación

• Guía del usuario

• Guía de uso de Docker

• Guía de compatibilidad

• Arquitectura

• Guía de integración de Claude

Ejemplos

El directorio examples contiene scripts que demuestran cómo interactuar con el servidor Memory MCP:

• 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 conocer los requisitos de dependencia

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

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

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