Sistema de memoria Cursor10x

Un sistema de memoria integral para Cursor utilizando el Protocolo de Contexto de Modelo (MCP).

🚀 ANUNCIANDO EL SISTEMA CURSOR10X 🚀

Transforme su proceso de desarrollo con sistemas autónomos impulsados por IA

🔥 ¡ El sistema de memoria Cursor10x ahora es parte de la plataforma completa Cursor10x! 🔥

Descubra el ecosistema de desarrollo autónomo completo en GitHub que incluye:

📋 Sistema de gestión de tareas : implementación guiada con tareas paso a paso 🔄 Memoria autónoma : IA consciente del contexto que recuerda todo el proyecto 📊 Planos del proyecto : arquitecturas técnicas completas creadas según sus especificaciones 📁 Arquitectura de archivos y carpetas : estructura de proyecto optimizada con las mejores prácticas 📘 Guía de implementación : documentación completa de todos los archivos y componentes 📝 Tareas detalladas : flujo de trabajo completo desde el inicio hasta la finalización del proyecto 🔍 Búsqueda basada en vectores : búsqueda semántica en toda la base de código y las conversaciones 🧩 Indexación de código : detección e indexación automáticas de estructuras de código 🔎 Recuperación de código semántico : encuentre código relacionado por significado en lugar de coincidencias exactas 🤖 Análisis automático de código : extraiga funciones, clases y variables con contexto

¡Genere planos de proyecto completos con arquitectura de archivos, guías de implementación y secuencias de tareas completas junto con todo el sistema Cursor10x ya implementado!

Descripción general

El sistema de memoria Cursor10x crea una capa de memoria persistente para los asistentes de IA (específicamente Claude), lo que les permite retener y recordar:

• Mensajes recientes e historial de conversaciones
• Archivos activos en los que se está trabajando actualmente
• Hitos y decisiones importantes del proyecto
• Requisitos técnicos y especificaciones
• Secuencias cronológicas de acciones y eventos (episodios)
• Fragmentos de código y estructuras de su base de código
• Contenido semánticamente similar basado en incrustaciones vectoriales
• Fragmentos de código relacionados a través de similitud semántica
• Estructuras de archivos con relaciones entre funciones y variables

Este sistema de memoria cierra la brecha entre las interacciones de IA sin estado y los flujos de trabajo de desarrollo continuo, lo que permite una asistencia más productiva y consciente del contexto.

Arquitectura del sistema

El sistema de memoria se basa en cuatro componentes principales:

1. Servidor MCP : implementa el protocolo de contexto de modelo para registrar herramientas y procesar solicitudes
2. Base de datos de memoria : utiliza la base de datos Turso para el almacenamiento persistente entre sesiones
3. Subsistemas de memoria : organiza la memoria en sistemas especializados con propósitos distintos.
4. Incrustaciones vectoriales : transforma texto y código en representaciones numéricas para búsqueda semántica

Tipos de memoria

El sistema implementa cuatro tipos de memoria complementarios:

1. Memoria a corto plazo (MCP)
   • Almacena mensajes recientes y archivos activos
   • Proporciona contexto inmediato para las interacciones actuales.
   • Prioriza automáticamente por actualidad e importancia
2. Memoria a largo plazo (MLP)
   • Almacena información permanente del proyecto, como hitos y decisiones.
   • Mantiene el contexto arquitectónico y de diseño.
   • Conserva información de alta importancia indefinidamente
3. Memoria episódica
   • Registra secuencias cronológicas de eventos.
   • Mantiene relaciones causales entre acciones
   • Proporciona contexto temporal para el historial del proyecto.
4. Memoria semántica
   • Almacena incrustaciones vectoriales de mensajes, archivos y fragmentos de código
   • Permite la recuperación de contenido en función de la similitud semántica.
   • Indexa automáticamente las estructuras de código para la recuperación contextual
   • Realiza un seguimiento de las relaciones entre los componentes del código
   • Proporciona una búsqueda basada en similitudes en todo el código base

Características

• Contexto persistente : mantiene la conversación y el contexto del proyecto en múltiples sesiones
• Almacenamiento basado en importancia : prioriza la información según niveles de importancia configurables
• Memoria multidimensional : combina sistemas de memoria a corto plazo, a largo plazo, episódica y semántica.
• Recuperación integral : proporciona un contexto unificado de todos los subsistemas de memoria
• Monitoreo de salud : incluye diagnósticos integrados e informes de estado
• Generación de banners : crea banners de contexto informativos para iniciar conversaciones
• Persistencia de la base de datos : almacena todos los datos de memoria en la base de datos de Turso con creación automática de esquemas
• Incrustaciones vectoriales : crea representaciones numéricas de texto y código para la búsqueda de similitud
• Almacenamiento vectorial avanzado : utiliza las funciones vectoriales y F32_BLOB de Turso para un almacenamiento de incrustación eficiente
• Búsqueda ANN : Admite la búsqueda aproximada del vecino más cercano para una rápida coincidencia de similitudes
• Indexación de código : detecta e indexa automáticamente las estructuras de código (funciones, clases, variables)
• Búsqueda semántica : encuentra contenido relacionado según el significado en lugar de coincidencias exactas de texto.
• Puntuación de relevancia : clasifica los elementos de contexto por relevancia para la consulta actual
• Detección de estructura de código : identifica y extrae componentes de código en varios lenguajes
• Generación de incrustaciones automáticas : crea automáticamente incrustaciones vectoriales para contenido indexado
• Recuperación de referencias cruzadas : encuentra código relacionado en diferentes archivos y componentes

Instalación

Prerrequisitos

• Node.js 18 o superior
• gestor de paquetes npm o yarn
• Cuenta de base de datos de Turso

Pasos de configuración

1. Configurar la base de datos de Turso:

O puede visitar Turso , registrarse y crear la base de datos, además de obtener las credenciales adecuadas. El plan gratuito cubrirá con creces la memoria de su proyecto.

2. Configurar el cursor MCP:

Actualice .cursor/mcp.json en el directorio de su proyecto con la URL de la base de datos y el token de autenticación de turso:

Documentación de herramientas

Herramientas del sistema

mcp_cursor10x_initConversation

Inicializa una conversación almacenando el mensaje del usuario, generando un banner y recuperando el contexto en una sola operación. Esta herramienta unificada elimina la necesidad de llamadas independientes a generateBanner, getComprehensiveContext y storeUserMessage al inicio de cada conversación.

Parámetros:

• content (cadena, obligatorio): Contenido del mensaje del usuario
• importance (cadena, opcional): nivel de importancia ("bajo", "medio", "alto", "crítico"), el valor predeterminado es "bajo"
• metadata (objeto, opcional): metadatos adicionales para el mensaje

Devoluciones:

• Objeto con dos secciones:
  • display : Contiene el banner que se mostrará al usuario
  • internal : contiene el contexto completo para el uso del agente

Ejemplo:

mcp_cursor10x_endConversation

Finaliza una conversación combinando varias operaciones en una sola llamada: almacena el mensaje final del asistente, registra un hito de lo logrado y registra un episodio en la memoria episódica. Esta herramienta unificada elimina la necesidad de llamadas independientes para almacenarAssistantMessage, almacenarMilestone y registrarEpisode al final de cada conversación.

Parámetros:

• content (cadena, obligatorio): Contenido del mensaje final del asistente
• milestone_title (cadena, obligatoria): Título del hito a registrar
• milestone_description (cadena, obligatoria): Descripción de lo que se logró
• importance (cadena, opcional): nivel de importancia ("bajo", "medio", "alto", "crítico"), el valor predeterminado es "medio"
• metadata (objeto, opcional): metadatos adicionales para todos los registros

Devoluciones:

• Objeto con estado y resultados de cada operación

Ejemplo:

mcp_cursor10x_checkHealth

Comprueba el estado del sistema de memoria y su conexión a la base de datos.

Parámetros:

• No se requiere ninguno

Devoluciones:

• Objeto con estado de salud y diagnóstico

Ejemplo:

mcp_cursor10x_getMemoryStats

Recupera estadísticas detalladas sobre el sistema de memoria.

Parámetros:

• No se requiere ninguno

Devoluciones:

• Objeto con estadísticas de memoria completas

Ejemplo:

mcp_cursor10x_getComprehensiveContext

Recupera un contexto unificado de todos los subsistemas de memoria, combinando la memoria a corto plazo, a largo plazo y episódica.

Parámetros:

• No se requiere ninguno

Devoluciones:

• Objeto con contexto consolidado de todos los sistemas de memoria

Ejemplo:

Herramientas de memoria a corto plazo

mcp_cursor10x_storeUserMessage

Almacena un mensaje de usuario en el sistema de memoria de corto plazo.

Parámetros:

• content (cadena, obligatorio): Contenido del mensaje
• importance (cadena, opcional): nivel de importancia ("bajo", "medio", "alto", "crítico"), el valor predeterminado es "bajo"
• metadata (objeto, opcional): metadatos adicionales para el mensaje

Devoluciones:

• Objeto con estado y marca de tiempo

Ejemplo:

mcp_cursor10x_storeAssistantMessage

Almacena un mensaje de asistente en el sistema de memoria a corto plazo.

Parámetros:

• content (cadena, obligatorio): Contenido del mensaje
• importance (cadena, opcional): nivel de importancia ("bajo", "medio", "alto", "crítico"), el valor predeterminado es "bajo"
• metadata (objeto, opcional): metadatos adicionales para el mensaje

Devoluciones:

• Objeto con estado y marca de tiempo

Ejemplo:

mcp_cursor10x_trackActiveFile

Realiza un seguimiento de un archivo activo al que el usuario accede o modifica.

Parámetros:

• filename (cadena, obligatorio): Ruta al archivo que se está rastreando
• action (cadena, obligatoria): Acción realizada en el archivo (abrir, editar, cerrar, etc.)
• metadata (objeto, opcional): metadatos adicionales para el evento de seguimiento

Devoluciones:

• Objeto con estado, nombre de archivo, acción y marca de tiempo

Ejemplo:

mcp_cursor10x_getRecentMessages

Recupera mensajes recientes de la memoria a corto plazo.

Parámetros:

• limit (número, opcional): número máximo de mensajes a recuperar, el valor predeterminado es 10
• importance (cadena, opcional): Filtrar por nivel de importancia

Devoluciones:

• Objeto con estado y matriz de mensajes

Ejemplo:

mcp_cursor10x_getActiveFiles

Recupera archivos activos de la memoria a corto plazo.

Parámetros:

• limit (número, opcional): número máximo de archivos a recuperar, el valor predeterminado es 10

Devoluciones:

• Objeto con estado y matriz de archivos activos

Ejemplo:

Herramientas de memoria a largo plazo

mcp_cursor10x_storeMilestone

Almacena un hito del proyecto en la memoria a largo plazo.

Parámetros:

• title (cadena, obligatoria): título del hito
• description (cadena, obligatoria): Descripción del hito
• importance (cadena, opcional): nivel de importancia, el valor predeterminado es "medio"
• metadata (objeto, opcional): metadatos adicionales para el hito

Devoluciones:

• Objeto con estado, título y marca de tiempo

Ejemplo:

mcp_cursor10x_storeDecision

Almacena una decisión de proyecto en la memoria a largo plazo.

Parámetros:

• title (cadena, obligatorio): Título de la decisión
• content (cadena, obligatorio): Contenido de la decisión
• reasoning (cadena, opcional): razonamiento detrás de la decisión
• importance (cadena, opcional): nivel de importancia, el valor predeterminado es "medio"
• metadata (objeto, opcional): metadatos adicionales para la decisión

Devoluciones:

• Objeto con estado, título y marca de tiempo

Ejemplo:

mcp_cursor10x_storeRequirement

Almacena un requisito de proyecto en la memoria a largo plazo.

Parámetros:

• title (cadena, obligatorio): Título del requisito
• content (cadena, obligatorio): Contenido del requisito
• importance (cadena, opcional): nivel de importancia, el valor predeterminado es "medio"
• metadata (objeto, opcional): metadatos adicionales para el requisito

Devoluciones:

• Objeto con estado, título y marca de tiempo

Ejemplo:

Herramientas de memoria episódica

mcp_cursor10x_recordEpisode

Registra un episodio (acción) en la memoria episódica.

Parámetros:

• actor (cadena, obligatorio): Actor que realiza la acción (usuario, asistente, sistema)
• action (cadena, obligatoria): tipo de acción realizada
• content (cadena, obligatorio): Contenido o detalles de la acción
• importance (cadena, opcional): nivel de importancia, el valor predeterminado es "bajo"
• context (cadena, opcional): contexto del episodio

Devoluciones:

• Objeto con estado, actor, acción y marca de tiempo

Ejemplo:

mcp_cursor10x_getRecentEpisodes

Recupera episodios recientes de la memoria episódica.

Parámetros:

• limit (número, opcional): número máximo de episodios a recuperar, el valor predeterminado es 10
• context (cadena, opcional): Filtrar por contexto

Devoluciones:

• Objeto con estado y matriz de episodios

Ejemplo:

Herramientas de memoria basadas en vectores

mcp_cursor10x_manageVector

Herramienta unificada para gestionar incrustaciones vectoriales con operaciones de almacenar, buscar, actualizar y eliminar.

Parámetros:

• operation (cadena, obligatoria): Operación a realizar ("almacenar", "buscar", "actualizar", "eliminar")
• contentId (número, opcional): ID del contenido que representa este vector (para almacenar, actualizar, eliminar)
• contentType (cadena, opcional): Tipo de contenido ("mensaje", "archivo", "fragmento", etc.)
• vector (matriz, opcional): datos vectoriales como matriz de números (para almacenar, actualizar) o vector de consulta (para búsqueda)
• vectorId (número, opcional): ID del vector a actualizar o eliminar
• limit (número, opcional): número máximo de resultados para la operación de búsqueda, el valor predeterminado es 10
• threshold (número, opcional): umbral de similitud para la operación de búsqueda, el valor predeterminado es 0,7
• metadata (objeto, opcional): información adicional sobre el vector

Devoluciones:

• Objeto con estado y resultados de la operación

Ejemplo:

Esquema de base de datos

El sistema de memoria crea y mantiene automáticamente las siguientes tablas de base de datos:

• messages : almacena mensajes del usuario y del asistente
  • id : Identificador único
  • timestamp : marca de tiempo de creación
  • role : Rol de mensaje (usuario/asistente)
  • content : Contenido del mensaje
  • importance : Nivel de importancia
  • archived : si el mensaje está archivado
• active_files : rastrea la actividad del archivo
  • id : Identificador único
  • filename : Ruta al archivo
  • action : Última acción realizada
  • last_accessed : Marca de tiempo del último acceso
• milestones : Registra los hitos del proyecto
  • id : Identificador único
  • title : Título del hito
  • description : Descripción detallada
  • timestamp : marca de tiempo de creación
  • importance : Nivel de importancia
• decisions : almacena las decisiones del proyecto
  • id : Identificador único
  • title : Título de la decisión
  • content : Contenido de la decisión
  • reasoning : Razonamiento de decisión
  • timestamp : marca de tiempo de creación
  • importance : Nivel de importancia
• requirements : Mantiene los requisitos del proyecto.
  • id : Identificador único
  • title : Título del requisito
  • content : Contenido del requisito
  • timestamp : marca de tiempo de creación
  • importance : Nivel de importancia
• episodes : Crónicas de acciones y acontecimientos
  • id : Identificador único
  • timestamp : marca de tiempo de creación
  • actor : Actor que realiza la acción
  • action : Tipo de acción
  • content : Detalles de la acción
  • importance : Nivel de importancia
  • context : Contexto de acción
• vectors : almacena incrustaciones de vectores para búsqueda semántica
  • id : Identificador único
  • content_id : ID del contenido referenciado
  • content_type : Tipo de contenido (mensaje, archivo, fragmento)
  • vector : Representación binaria del vector de incrustación
  • metadata : metadatos adicionales para el vector
• code_files : rastrea archivos de código indexados
  • id : Identificador único
  • file_path : Ruta al archivo
  • language : lenguaje de programación
  • last_indexed : Marca de tiempo de la última indexación
  • metadata : metadatos de archivos adicionales
• code_snippets : almacena estructuras de código extraídas
  • id : Identificador único
  • file_id : Referencia al archivo padre
  • start_line : Número de línea de inicio
  • end_line : Número de línea final
  • symbol_type : Tipo de estructura de código (función, clase, variable)
  • content : El contenido del fragmento de código

Flujos de trabajo de ejemplo

Inicio de conversación optimizado

Iniciar una nueva sesión (método alternativo)

Seguimiento de la actividad del usuario

Solución de problemas

Problemas comunes

1. Problemas de conexión a la base de datos
   • Verifique que la URL de su base de datos de Turso y el token de autenticación sean correctos
   • Verifique la conectividad de red al servicio Turso
   • Verificar que la configuración del firewall permita la conexión
2. Datos faltantes
   • Verifique que los datos se almacenaron con el nivel de importancia apropiado
   • Verificar los parámetros de consulta de recuperación (límite, filtros)
   • Verifique el estado de la base de datos con mcp_cursor10x_checkHealth()
3. Problemas de rendimiento
   • Supervisar las estadísticas de memoria con mcp_cursor10x_getMemoryStats()
   • Considere archivar datos antiguos si la base de datos crece demasiado
   • Optimice la recuperación mediante el uso de filtros más específicos

Pasos de diagnóstico

1. Comprobar el estado del sistema:
   const health = await mcp_cursor10x_checkHealth({}); console.log("System Health:", health);
2. Verificar estadísticas de memoria:
   const stats = await mcp_cursor10x_getMemoryStats({}); console.log("Memory Stats:", stats);
3. Generar un banner de estado:
   const banner = await mcp_cursor10x_generateBanner({}); console.log("Memory Banner:", banner);

Niveles de importancia

Al almacenar elementos en la memoria, utilice niveles de importancia apropiados:

• bajo : Información general, operaciones rutinarias, conversaciones cotidianas
• medio : contexto útil, elementos de trabajo estándar, funciones habituales
• Alto : Decisiones críticas, características principales, elementos importantes de la arquitectura.
• Crítico : arquitectura central, problemas de seguridad, problemas de integridad de los datos

Licencia

Instituto Tecnológico de Massachusetts (MIT)