Servidor de memoria MCP

Este servidor implementa capacidades de memoria a largo plazo para asistentes de IA utilizando principios mem0, impulsados por PostgreSQL con pgvector para una búsqueda eficiente de similitud de vectores.

Características

• PostgreSQL con pgvector para búsqueda de similitud vectorial

• Generación automática de incrustaciones mediante BERT

• API RESTful para operaciones de memoria

• Capacidades de búsqueda semántica

• Soporte para diferentes tipos de memorias (aprendizajes, vivencias, etc.)

• Recuperación de memoria basada en etiquetas

• Puntuación de confianza para los recuerdos

• Eventos enviados por el servidor (SSE) para actualizaciones en tiempo real

• Compatible con el protocolo Cursor MCP

Prerrequisitos

1. PostgreSQL 14+ con la extensión pgvector instalada:

2. Node.js 16+

Configuración

1. Instalar dependencias:

2. Configurar variables de entorno: Copie .env.sample a .env y ajuste los valores:

Ejemplo de configuraciones .env :

3. Inicializar la base de datos:

4. Iniciar el servidor:

Para desarrollo con recarga automática:

Uso con cursor

Agregar el servidor MCP en Cursor

Para agregar el servidor de memoria a Cursor, debe modificar el archivo de configuración de MCP, ubicado en ~/.cursor/mcp.json . Agregue la siguiente configuración al objeto mcpServers :

Reemplace /path/to/your/memory con la ruta real a la instalación de su servidor de memoria.

Por ejemplo, si clonó el repositorio en /Users/username/workspace/memory , su configuración se vería así:

Cursor iniciará automáticamente el servidor cuando sea necesario. Puedes comprobar su funcionamiento:

1. Cursor de apertura

2. El servidor de memoria se iniciará automáticamente cuando se inicie Cursor

3. Puede comprobar el estado del servidor visitando http://localhost:3333/mcp/v1/health

Puntos finales MCP disponibles

Conexión SSE

• Punto final : GET /mcp/v1/sse

• Parámetros de consulta :

  • subscribe : Lista separada por comas de eventos a los que suscribirse (opcional)

• Eventos :

  • connected : enviado en la conexión inicial

  • memory.created : se envía cuando se crean nuevos recuerdos

  • memory.updated : se envía cuando se actualizan las memorias existentes

Operaciones de memoria

1. Crear memoria

2. Buscar recuerdos

3. Lista de recuerdos

Chequeo de salud

Formato de respuesta

Todas las respuestas de API siguen el formato MCP estándar:

O para errores:

Esquema de memoria

• id: Identificador único

• tipo: Tipo de memoria (aprendizaje, experiencia, etc.)

• contenido: Contenido de memoria real (JSON)

• fuente: De donde vino el recuerdo

• incrustación: Representación vectorial del contenido (384 dimensiones)

• etiquetas: Matriz de etiquetas relevantes

• confianza: Puntuación de confianza (0-1)

• createdAt: Cuando se creó la memoria

• updatedAt: Cuándo se actualizó la memoria por última vez