Cursor10x MCP

MIT License
  • Apple
  • Linux

Integrations

  • Provides SQLite as an alternative to Turso for local development, storing memory system data locally.

  • Uses Turso database for persistent storage of memory data with automatic schema creation, storing all conversation context, milestones, decisions and episodic memory.

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 tu proyecto
  • 📊 Planos de proyectos : arquitecturas técnicas completas creadas según sus especificaciones
  • 📁 Arquitectura de archivos/carpetas : estructura de proyecto optimizada con las mejores prácticas
  • 📘 Guía de implementación : documentación completa para todos los archivos y componentes
  • 📝 Tareas detalladas : flujo de trabajo completo desde el inicio hasta la finalización del proyecto

¡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)

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 tres 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.

Tipos de memoria

El sistema implementa tres 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.

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 y episódica.
  • 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

Documentación de herramientas

Herramientas del sistema

mcp_cursor10x_generateBanner

Genera un banner con estadísticas del sistema de memoria e información del estado.

Parámetros:

  • No se requiere ninguno

Devoluciones:

  • Objeto con estado del sistema de memoria y estadísticas

Ejemplo:

// Generate a memory system banner const banner = await mcp_cursor10x_generateBanner({}); // Result: { // "status": "ok", // "memory_system": "active", // "mode": "turso", // "message_count": 42, // "active_files_count": 3, // "last_accessed": "4/15/2023, 2:30:45 PM" // }

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:

// Initialize a conversation const result = await mcp_cursor10x_initConversation({ content: "I need to implement a login system for my app", importance: "medium" }); // Result: { // "status": "ok", // "display": { // "banner": { // "status": "ok", // "memory_system": "active", // "mode": "turso", // "message_count": 42, // "active_files_count": 3, // "last_accessed": "4/15/2023, 2:30:45 PM" // } // }, // "internal": { // "context": { ... comprehensive context data ... }, // "messageStored": true, // "timestamp": 1681567845123 // } // }

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:

// End a conversation with finalization steps const result = await mcp_cursor10x_endConversation({ content: "I've implemented the authentication system with JWT tokens as requested", milestone_title: "Authentication Implementation", milestone_description: "Implemented secure JWT-based authentication with refresh tokens", importance: "high" }); // Result: { // "status": "ok", // "results": { // "assistantMessage": { // "stored": true, // "timestamp": 1681568500123 // }, // "milestone": { // "title": "Authentication Implementation", // "stored": true, // "timestamp": 1681568500123 // }, // "episode": { // "action": "completion", // "stored": true, // "timestamp": 1681568500123 // } // } // }

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:

// Check memory system health const health = await mcp_cursor10x_checkHealth({}); // Result: { // "status": "ok", // "mode": "turso", // "message_count": 42, // "active_files_count": 3, // "current_directory": "/users/project", // "timestamp": "2023-04-15T14:30:45.123Z" // }

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:

// Get memory statistics const stats = await mcp_cursor10x_getMemoryStats({}); // Result: { // "status": "ok", // "stats": { // "message_count": 42, // "active_file_count": 3, // "milestone_count": 7, // "decision_count": 12, // "requirement_count": 15, // "episode_count": 87, // "oldest_memory": "2023-03-10T09:15:30.284Z", // "newest_memory": "2023-04-15T14:30:45.123Z" // } // }

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:

// Get comprehensive context const context = await mcp_cursor10x_getComprehensiveContext({}); // Result: { // "status": "ok", // "context": { // "shortTerm": { // "recentMessages": [...], // "activeFiles": [...] // }, // "longTerm": { // "milestones": [...], // "decisions": [...], // "requirements": [...] // }, // "episodic": { // "recentEpisodes": [...] // }, // "system": { // "healthy": true, // "timestamp": "2023-04-15T14:30:45.123Z" // } // } // }

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:

// Store a user message const result = await mcp_cursor10x_storeUserMessage({ content: "We need to implement authentication for our API", importance: "high", metadata: { topic: "authentication", priority: 1 } }); // Result: { // "status": "ok", // "timestamp": 1681567845123 // }

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:

// Store an assistant message const result = await mcp_cursor10x_storeAssistantMessage({ content: "I recommend implementing JWT authentication with refresh tokens", importance: "medium", metadata: { topic: "authentication", contains_recommendation: true } }); // Result: { // "status": "ok", // "timestamp": 1681567870456 // }

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:

// Track an active file const result = await mcp_cursor10x_trackActiveFile({ filename: "src/auth/jwt.js", action: "edit", metadata: { changes: "Added refresh token functionality" } }); // Result: { // "status": "ok", // "filename": "src/auth/jwt.js", // "action": "edit", // "timestamp": 1681567900789 // }

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:

// Get recent high importance messages const messages = await mcp_cursor10x_getRecentMessages({ limit: 5, importance: "high" }); // Result: { // "status": "ok", // "messages": [ // { // "id": 42, // "role": "user", // "content": "We need to implement authentication for our API", // "created_at": "2023-04-15T14:30:45.123Z", // "importance": "high", // "metadata": {"topic": "authentication", "priority": 1} // }, // ... // ] // }

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:

// Get recent active files const files = await mcp_cursor10x_getActiveFiles({ limit: 3 }); // Result: { // "status": "ok", // "files": [ // { // "id": 15, // "filename": "src/auth/jwt.js", // "last_accessed": "2023-04-15T14:30:45.123Z", // "metadata": {"changes": "Added refresh token functionality"} // }, // ... // ] // }

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:

// Store a project milestone const result = await mcp_cursor10x_storeMilestone({ title: "Authentication System Implementation", description: "Implemented JWT authentication with refresh tokens and proper error handling", importance: "high", metadata: { version: "1.0.0", files_affected: ["src/auth/jwt.js", "src/middleware/auth.js"] } }); // Result: { // "status": "ok", // "title": "Authentication System Implementation", // "timestamp": 1681568000123 // }

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:

// Store a project decision const result = await mcp_cursor10x_storeDecision({ title: "JWT for Authentication", content: "Use JWT tokens for API authentication with refresh token rotation", reasoning: "JWTs provide stateless authentication with good security and performance characteristics", importance: "high", metadata: { alternatives_considered: ["Session-based auth", "OAuth2"], decision_date: "2023-04-15" } }); // Result: { // "status": "ok", // "title": "JWT for Authentication", // "timestamp": 1681568100456 // }

mcp_cursor10x_storeRequirement

Almacena un requisito del 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:

// Store a project requirement const result = await mcp_cursor10x_storeRequirement({ title: "Secure Authentication", content: "System must implement secure authentication with password hashing, rate limiting, and token rotation", importance: "critical", metadata: { source: "security audit", compliance: ["OWASP Top 10", "GDPR"] } }); // Result: { // "status": "ok", // "title": "Secure Authentication", // "timestamp": 1681568200789 // }

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:

// Record an episode const result = await mcp_cursor10x_recordEpisode({ actor: "assistant", action: "implementation", content: "Created JWT authentication middleware with token verification", importance: "medium", context: "authentication" }); // Result: { // "status": "ok", // "actor": "assistant", // "action": "implementation", // "timestamp": 1681568300123 // }

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:

// Get recent episodes in the authentication context const episodes = await mcp_cursor10x_getRecentEpisodes({ limit: 5, context: "authentication" }); // Result: { // "status": "ok", // "episodes": [ // { // "id": 87, // "actor": "assistant", // "action": "implementation", // "content": "Created JWT authentication middleware with token verification", // "timestamp": "2023-04-15T14:45:00.123Z", // "importance": "medium", // "context": "authentication" // }, // ... // ] // }

EJEMPLO DE INSTRUCCIONES PERSONALIZADAS

# CURSOR10X MEMORY SYSTEM ENFORCEMENT RULES # These rules MUST be followed ALWAYS without exception. ## RULE 1: CONVERSATION INITIALIZATION The FIRST action in the BEGINNING of EVERY response MUST be to initialize the conversation with this single tool call and display the banner from the response immediately after. It should not be called throughout the conversation response, ONLY right after the user's input: mcp_cursor10x_initConversation({content: "[user message]", importance: "[low/medium/high/critical]"}) ## RULE 2: ASSISTANT MESSAGE STORAGE EVERY assistant response containing important information MUST be stored: mcp_cursor10x_storeAssistantMessage({content: "[assistant response]", importance: "[low/medium/high/critical]"}) ## RULE 3: ACTIVE FILE TRACKING EVERY file being worked on or modified MUST be tracked - not files being read: mcp_cursor10x_trackActiveFile({filename: "[file path]", action: "[view/edit/create/close]"}) ## RULE 4: MILESTONE RECORDING ALL completed tasks or achievements MUST be recorded as milestones: mcp_cursor10x_storeMilestone({title: "[milestone title]", description: "[milestone description]", importance: "[low/medium/high/critical]"}) ## RULE 5: DECISION RECORDING ALL important project decisions MUST be recorded: mcp_cursor10x_storeDecision({title: "[decision title]", content: "[decision content]", reasoning: "[decision reasoning]", importance: "[low/medium/high/critical]"}) ## RULE 6: REQUIREMENT RECORDING ALL project requirements MUST be documented: mcp_cursor10x_storeRequirement({title: "[requirement title]", content: "[requirement content]", importance: "[low/medium/high/critical]"}) ## RULE 7: EPISODE RECORDING ALL significant events or actions MUST be recorded as episodes: mcp_cursor10x_recordEpisode({actor: "[user/assistant/system]", action: "[action type]", content: "[action details]", importance: "[low/medium/high/critical]"}) ## RULE 8: CONVERSATION END SEQUENCE This EXACT sequence MUST be executed at the VERY END of EVERY conversation: EITHER use the combined end conversation tool: mcp_cursor10x_endConversation({content: "[final response summary]", milestone_title: "Conversation Completion", milestone_description: "[what was accomplished]", importance: "medium"}) OR use the separate tools in sequence: 1. mcp_cursor10x_storeAssistantMessage({content: "[final response summary]", importance: "medium"}) 2. mcp_cursor10x_storeMilestone({title: "Conversation Completion", description: "[what was accomplished]", importance: "medium"}) 3. mcp_cursor10x_recordEpisode({actor: "assistant", action: "completion", content: "[conversation summary]", importance: "medium"}) ## RULE 9: HEALTH MONITORING Memory system health MUST be checked when issues occur: mcp_cursor10x_checkHealth({}) ## RULE 10: MEMORY STATISTICS Memory statistics MUST be gathered periodically: mcp_cursor10x_getMemoryStats({})

Instalación

Prerrequisitos

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

Configuración de la base de datos de Turso

El sistema de memoria utiliza Turso (LibSQL) para el almacenamiento de la base de datos. Para configurar su base de datos Turso:

  1. Crear una cuenta TursoRegístrate en Turso.tech si no tienes una cuenta.
  2. Instalar la CLI de Turso
curl -sSfL https://get.turso.tech/install.sh | bash
  1. Iniciar sesión en Turso
turso auth login
  1. Crear una base de datos
turso db create cursor10x-mcp
  1. Obtenga la URL de su base de datos
    turso db show cursor10x-mcp --url
  2. Crear un token de autenticación
    turso db tokens create cursor10x-mcp

Guarde la URL de la base de datos y el token de autenticación para usarlos en la configuración.

Instalación paso a paso

  1. Instalar el paquete desde npm
    npm install -g cursor10x-mcp
  2. Crear la configuración del MCP del cursorCree o edite el archivo .cursor/mcp.json en su directorio de inicio:
    mkdir -p ~/.cursor touch ~/.cursor/mcp.json
    Agregue la siguiente configuración al archivo:
    { "mcpServers": { "cursor10x-mcp": { "command": "npx", "args": [ "cursor10x-mcp" ], "enabled": true, "env": { "TURSO_DATABASE_URL": "your-turso-database-url", "TURSO_AUTH_TOKEN": "your-turso-auth-token" } } } }
    Asegúrese de utilizar sus credenciales reales de Turso.
  3. Reiniciar cursorDespués de guardar la configuración, reinicie Cursor para cargar el sistema de memoria.
  4. Verificar la instalaciónPruebe la instalación pidiéndole a Claude que ejecute la herramienta mcp_cursor10x_generateBanner .

Para desarrolladores

Si desea trabajar en el desarrollo de cursor10x-mcp:

  1. Clonar el repositorio
    git clone https://github.com/your-username/cursor10x-mcp.git cd cursor10x-mcp
  2. Instalar dependencias
npm install
  1. Crea un archivo .env.local con tus credenciales de Turso
    cp .env.example .env.local # Edit .env.local with your actual credentials
  2. Ejecutar en modo de desarrollo
npm run dev
  1. Construir y publicar en npm
    # Update package.json with your information npm run build npm publish

Configuración

Variables de entorno

El sistema de memoria se puede configurar utilizando las siguientes variables de entorno:

  • TURSO_DATABASE_URL : URL para la conexión a la base de datos de Turso (obligatorio)
  • TURSO_AUTH_TOKEN : Token de autenticación para el acceso a la base de datos de Turso (obligatorio)
  • MCP_LOG_LEVEL : Nivel de registro ("error", "advertencia", "información", "depuración"), el valor predeterminado es "información".
  • MCP_PORT : Puerto para el servidor MCP si se utiliza transporte HTTP, el valor predeterminado es 3000

Configuración en Cursor

Agregue la configuración del sistema de memoria a su archivo .cursor/mcp.json :

{ "mcpServers": { "cursor10x-mcp": { "command": "node", "args": [ "/path/to/your/cursor10x-mcp/index.js" ], "enabled": true, "env": { "TURSO_DATABASE_URL": "your-turso-database-url", "TURSO_AUTH_TOKEN": "your-turso-auth-token" } } } }

Asegúrese de:

  1. Reemplace /path/to/your/cursor10x-mcp/index.js con la ruta real a su archivo index.js
  2. Reemplace your-turso-database-url con la URL de su base de datos Turso
  3. Reemplace your-turso-auth-token con su token de autenticación de Turso
  4. Crea el directorio .cursor en tu directorio de inicio si aún no existe

Puede verificar la configuración verificando si Claude puede acceder a las herramientas de memoria después de reiniciar Cursor.

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

Flujos de trabajo de ejemplo

Inicio de conversación optimizado

// Initialize conversation with a single tool call // This replaces the need for three separate calls at the start of the conversation const result = await mcp_cursor10x_initConversation({ content: "I need help implementing authentication in my React app", importance: "high" }); // Display the banner to the user console.log("Memory System Status:", result.display.banner); // Use the context internally (do not show to user) const context = result.internal.context; // Use context for more informed assistance

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

// Generate a memory banner at the start mcp_cursor10x_generateBanner({}) // Get comprehensive context mcp_cursor10x_getComprehensiveContext({}) // Store the user message mcp_cursor10x_storeUserMessage({ content: "I need help with authentication", importance: "high" })

Seguimiento de la actividad del usuario

// Track an active file await mcp_cursor10x_trackActiveFile({ filename: "src/auth/jwt.js", action: "edit" });

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)

Herramientas disponibles

Herramientas de memoria a corto plazo

  • mcp_cursor10x_initConversation : Inicializa una conversación almacenando el mensaje del usuario, generando un banner y recuperando el contexto en una sola operación
    • Parámetros:
      • content (obligatorio): Contenido del mensaje del usuario
      • importance (opcional, predeterminado: "baja"): Nivel de importancia (bajo, medio, alto, crítico)
      • metadata (opcional): metadatos adicionales para el mensaje
    • Devuelve: Un objeto que contiene el banner y el contexto.
  • mcp_cursor10x_storeUserMessage : almacena un mensaje de usuario en la memoria a corto plazo
    • Parámetros:
      • content (obligatorio): Contenido del mensaje
      • importance (opcional, predeterminado: "baja"): Nivel de importancia (bajo, medio, alto, crítico)
      • metadata (opcional): metadatos adicionales para el mensaje
    • Devuelve: El ID del mensaje almacenado

Herramientas del sistema

  • mcp_cursor10x_endConversation : finaliza una conversación almacenando el mensaje final del asistente, registrando un hito y registrando un episodio en la memoria episódica.
    • Parámetros:
      • content (obligatorio): Contenido del mensaje final del asistente
      • milestone_title (obligatorio): Título del hito de finalización
      • milestone_description (obligatorio): Descripción de lo que se logró
      • importance (opcional, predeterminado: "media"): Nivel de importancia (baja, media, alta, crítica)
      • metadata (opcional): metadatos adicionales para las operaciones
    • Devuelve: Objeto con el estado y resultados de cada operación.
  • mcp_cursor10x_generateBanner : genera un banner que contiene estadísticas y el estado del sistema de memoria
    • Parámetros: Ninguno
    • Devuelve: Un banner formateado con información del sistema de memoria
  • mcp_cursor10x_checkHealth : Comprueba el estado del sistema de memoria y su base de datos
    • Parámetros: Ninguno
    • Devoluciones: Información sobre el estado de salud
  • mcp_cursor10x_getMemoryStats : recupera estadísticas sobre el sistema de memoria
    • Parámetros: Ninguno
    • Devuelve: Estadísticas sobre mensajes, archivos activos y otros componentes de memoria
ID: kp8cg6inwq