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 escalonada : niveles de memoria a corto plazo, a 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
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

Arquitectura

El servidor MCP sigue una arquitectura funcional basada en dominio con los siguientes componentes:

┌─────────────────────────────────────────────────────────┐
│                   Claude Desktop                        │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│                     MCP Interface                       │
│  ┌─────────────────┐  ┌─────────────────┐  ┌──────────┐ │
│  │ Tool Definitions│  │ Request Handler │  │ Security │ │
│  └─────────────────┘  └─────────────────┘  └──────────┘ │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│                Memory Domain Manager                    │
├─────────────────┬─────────────────┬────────────────────┤
│  Episodic Domain│  Semantic Domain│  Temporal Domain   │
├─────────────────┴─────────────────┴────────────────────┤
│                  Persistence Domain                    │
└─────────────────────────────────────────────────────────┘

Dominios funcionales

Dominio episódico : gestiona las interacciones basadas en sesiones y la memoria contextual.
Dominio semántico : maneja la organización y recuperación del conocimiento.
Dominio temporal : controla el procesamiento de los recuerdos en función del tiempo.
Dominio de persistencia : administra la optimización y recuperación del almacenamiento

Instalación

Prerrequisitos

Python 3.8 o superior
gestor de paquetes pip

Pasos de instalación

Clonar el repositorio:
git clone https://github.com/WhenMoon-afk/claude-memory-mcp.git cd claude-memory-mcp
Instalar dependencias:
pip install -e .
Ejecute el script de configuración:
chmod +x setup.sh ./setup.sh

Integración de escritorio de Claude

Para integrarse con la aplicación de escritorio 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"
      }
    }
  }
}

Estructura del archivo de memoria

El sistema de memoria utiliza una estructura de archivos basada en JSON con los siguientes componentes:

{
  "metadata": {
    "version": "1.0",
    "created_at": "ISO-8601 timestamp",
    "updated_at": "ISO-8601 timestamp"
  },
  "memory_index": {
    // Vector index for fast semantic search
  },
  "short_term_memory": [
    // Recent and frequently accessed memories
  ],
  "long_term_memory": [
    // Older or less frequently accessed memories
  ],
  "archived_memory": [
    // Rarely accessed but potentially valuable memories
  ],
  "memory_schema": {
    // Schema definitions for memory entries
  },
  "config": {
    // Configuration settings for memory management
  }
}

Uso

Iniciando el servidor

python -m memory_mcp

Herramientas disponibles

store_memory : Almacenar nueva información en la memoria
retrieve_memory : recupera recuerdos relevantes según la consulta
list_memories : Lista de recuerdos disponibles con opciones de filtrado
update_memory : Actualizar las entradas de memoria existentes
delete_memory : Eliminar memorias específicas
memory_stats : Obtener estadísticas sobre el almacén de memoria

Desarrollo

Estructura del proyecto

memory_mcp/
├── memory/
│   ├── models.py         # Memory data models
│   ├── storage.py        # Memory storage operations
│   ├── retrieval.py      # Memory retrieval operations
│   └── consolidation.py  # Memory consolidation operations
├── domains/
│   ├── episodic.py       # Episodic memory domain
│   ├── semantic.py       # Semantic knowledge domain
│   ├── temporal.py       # Temporal processing domain
│   └── persistence.py    # Storage and retrieval domain
├── mcp/
│   ├── server.py         # MCP server implementation
│   ├── tools.py          # MCP tool definitions
│   └── handler.py        # Request handling
├── security/
│   └── validation.py     # Input validation
└── utils/
    ├── embeddings.py     # Vector embedding utilities
    └── schema.py         # Schema validation

Ejecución de pruebas

pytest

Antecedentes de la investigación

Esta implementación se basa en una investigación exhaustiva de las técnicas actuales de memoria persistente LLM:

Gestión de memoria inspirada en el sistema operativo : arquitectura de memoria en niveles similar a MemGPT
Memoria episódica de inspiración biológica : recuperación de la memoria sensible al contexto
Incrustaciones vectoriales : búsqueda semántica inspirada en enfoques de bases de datos vectoriales
Autorreflexión : Consolidación de la memoria mediante la revisión periódica

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.

Expresiones de gratitud

Basado en la investigación de técnicas de memoria óptimas para LLM
Implementa el Protocolo de Contexto de Modelo para la integración con Claude

Claude Memory MCP Server