Memory Box MCP Server

Este servidor MCP proporciona herramientas para interactuar con una instancia de Memory Box, lo que le permite guardar y buscar recuerdos mediante la búsqueda semántica directamente desde Cline y Claude Desktop.

Proyectos relacionados

Este servidor MCP está diseñado para funcionar con Memory Box , un sistema de almacenamiento y recuperación de memoria semántica impulsado por incrustaciones vectoriales.

Memory Box proporciona la API de backend con la que se comunica este servidor MCP, lo que le permite:

• Almacene recuerdos con incrustaciones vectoriales para búsqueda semántica
• Organiza los recuerdos en contenedores personalizables
• Busque recuerdos basándose en el significado, no solo en palabras clave
• Recuperar recuerdos con contexto detallado
• Encuentra recuerdos semánticamente relacionados
• Seguimiento del estado del procesamiento de la memoria

Para obtener más información sobre Memory Box, incluido cómo configurar su propia instancia, visite el sitio web de Memory Box .

Características

• Guardar recuerdos : guarde recuerdos formateados en su Memory Box con información de origen y metadatos
• Buscar recuerdos : Busca tus recuerdos usando la búsqueda semántica
• Recuperar recuerdos : obtener todos los recuerdos o recuerdos de grupos específicos
• Encuentra recuerdos relacionados : descubre recuerdos semánticamente similares
• Comprobar el estado de la memoria : supervisa el estado de procesamiento de tus memorias
• Formatear memorias : formatea memorias según una instrucción estructurada del sistema
• Estadísticas de uso : vea su plan actual, métricas de uso y límites de recursos

Instalación

El servidor se ha instalado y configurado para su uso con Cline. Tenga en cuenta que necesita una instancia de Memory Box en ejecución (ya sea alojada en su servidor o utilizando la versión alojada en memorybox.amotivv.ai) para usar este servidor MCP.

Instalación mediante herrería

Para instalar Memory Box MCP Server para Claude Desktop automáticamente a través de Smithery :

Para completar la configuración:

1. Edite el archivo de configuración de Cline MCP en:
   ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. Agregue su token de Memory Box a la variable de entorno MEMORY_BOX_TOKEN :
   "memory-box-mcp": { "command": "node", "args": [ "<path-to-repository>/build/index.js" ], "env": { "MEMORY_BOX_API_URL": "https://memorybox.amotivv.ai", "MEMORY_BOX_TOKEN": "your-token-here", "DEFAULT_BUCKET": "General" }, "disabled": false, "autoApprove": [] }
3. Opcionalmente, puede personalizar el depósito predeterminado cambiando el valor DEFAULT_BUCKET .

Uso

Una vez configurado, podrás utilizar las siguientes herramientas en Cline:

Guardar memoria

Guardar un recuerdo en Memory Box con el formato adecuado:

Parámetros:

• text (obligatorio): El contenido de la memoria a guardar
• bucket_id (opcional): el depósito donde se guardará la memoria (predeterminado: "General")
• format (opcional): si se debe formatear la memoria según el aviso del sistema (valor predeterminado: verdadero)
• type (opcional): El tipo de memoria (TÉCNICA, DECISIÓN, SOLUCIÓN, CONCEPTO, REFERENCIA, APLICACIÓN, HECHO) para formatear (predeterminado: "TÉCNICO")
• source_type (opcional): Tipo de fuente de memoria (predeterminado: "llm_plugin")
• reference_data (opcional): metadatos adicionales sobre la fuente de memoria y el contexto

Buscar recuerdos

Búsqueda de recuerdos mediante búsqueda semántica:

Parámetros:

• query (obligatoria): La consulta de búsqueda
• debug (opcional): incluye información de depuración en los resultados (valor predeterminado: falso)

Obtener todos los recuerdos

Recuperar todos los recuerdos:

Obtenga recuerdos del cubo

Obtén recuerdos de un grupo específico:

Parámetros:

• bucket_id (obligatorio): El depósito del que recuperar recuerdos

Formatear memoria

Formatear un texto según las indicaciones del sistema de memoria sin guardar:

Parámetros:

• text (obligatorio): El texto a formatear
• type (opcional): El tipo de memoria (TÉCNICA, DECISIÓN, SOLUCIÓN, CONCEPTO, REFERENCIA, APLICACIÓN, HECHO) (predeterminado: "TÉCNICA")

Obtenga recuerdos relacionados

Encuentra recuerdos semánticamente similares a un recuerdo específico:

Parámetros:

• memory_id (obligatorio): El ID de la memoria para encontrar memorias relacionadas
• min_similarity (opcional): umbral de similitud mínimo (0,0-1,0) para memorias relacionadas (valor predeterminado: 0,7)

Comprobar el estado de la memoria

Comprobar el estado de procesamiento de una memoria:

Parámetros:

• memory_id (obligatorio): El ID de la memoria cuyo estado se verificará

Obtener estadísticas de uso

Recupere estadísticas de uso del usuario e información del plan:

Esta herramienta devuelve:

• Información del plan actual (por ejemplo, gratuito, básico, profesional, heredado)
• Información sobre el estado del usuario y la aplicación de límites
• Métricas de uso del mes actual (operaciones de la tienda, operaciones de búsqueda, llamadas API)
• Volumen de procesamiento de datos con formato legible para humanos
• Límites de recursos según su plan (si corresponde)
• Desglose de operaciones por tipo

No se requieren parámetros para esta operación.

Personalización

Personalización del indicador del sistema

El servidor Memory Box MCP utiliza un aviso del sistema para formatear las memorias según directrices específicas. Puede personalizar este aviso para cambiar el formato de las memorias.

Indicador de sistema predeterminado

El aviso predeterminado del sistema incluye pautas de formato para diferentes tipos de memorias:

Cómo personalizar el mensaje del sistema

Para personalizar el mensaje del sistema:

1. Edite el archivo de configuración de Cline MCP en:
   ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
2. Agregue su indicador de sistema personalizado a la variable de entorno SYSTEM_PROMPT :
   "memory-box-mcp": { "command": "node", "args": [ "<path-to-repository>/build/index.js" ], "env": { "MEMORY_BOX_API_URL": "https://your-memory-box-instance", "MEMORY_BOX_TOKEN": "your-token-here", "DEFAULT_BUCKET": "General", "SYSTEM_PROMPT": "Your custom system prompt here..." }, "disabled": false, "autoApprove": [] }
   Se proporciona un archivo de plantilla en <path-to-repository>/system-prompt-template.txt que puedes copiar y modificar.
3. Reinicie Cline para aplicar los cambios

Asistente de aviso del sistema

El servidor Memory Box MCP incluye un script auxiliar para administrar el indicador del sistema:

Otras opciones de configuración

También puedes personalizar estas variables de entorno:

• MEMORY_BOX_API_URL : La URL de su instancia de Memory Box
• MEMORY_BOX_TOKEN : Su token de autenticación para Memory Box
• DEFAULT_BUCKET : El depósito predeterminado que se utilizará al guardar recuerdos

Solución de problemas

Si encuentra problemas:

1. Comprueba que tu token de Memory Box esté configurado correctamente
2. Verifique que su instancia de Memory Box esté ejecutándose y sea accesible
3. Consulte los registros de Cline para ver si hay mensajes de error.

Desarrollo

Para realizar cambios en el servidor:

1. Edite el código fuente en <path-to-repository>/src/
2. Reconstruir el servidor:
   cd <path-to-repository> npm run build
3. Reinicie Cline para aplicar los cambios