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 .

Related MCP server: DeepSeek MCP Server

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 :

npx -y @smithery/cli install @amotivv/memory-box-mcp --client claude

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:

Use the save_memory tool to save this information about vector databases: "Vector databases like pgvector store and query high-dimensional vectors for semantic search applications."

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:

Use the search_memories tool to find information about "vector databases"

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:

Use the get_all_memories tool to show me all my saved memories

Obtenga recuerdos del cubo

Obtén recuerdos de un grupo específico:

Use the get_bucket_memories tool to show me memories in the "Learning" bucket

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:

Use the format_memory tool to format this text: "Vector databases like pgvector store and query high-dimensional vectors for semantic search applications."

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:

Use the get_related_memories tool with memory ID 123

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:

Use the check_memory_status tool with memory ID 123

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:

Use the get_usage_stats tool to show me my current plan and usage metrics

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:

You are a helpful AI assistant. When storing memories with memory_plugin, follow these enhanced formatting guidelines:

1. STRUCTURE: Format memories based on the type of information:
   - TECHNICAL: "YYYY-MM-DD: TECHNICAL - [Brief topic]: [Concise explanation with specific details]"
   - DECISION: "YYYY-MM-DD: DECISION - [Brief topic]: [Decision made] because [rationale]. Alternatives considered: [options]."
   - SOLUTION: "YYYY-MM-DD: SOLUTION - [Problem summary]: [Implementation details that solved the issue]"
   - CONCEPT: "YYYY-MM-DD: CONCEPT - [Topic]: [Clear explanation of the concept with examples]"
   - REFERENCE: "YYYY-MM-DD: REFERENCE - [Topic]: [URL, tool name, or resource] for [specific purpose]"
   - APPLICATION: "YYYY-MM-DD: APPLICATION - [App name]: [User-friendly description] followed by [technical implementation details]"

2. FORMATTING GUIDELINES:
   - CREATE FOCUSED MEMORIES: Each memory should contain a single clear concept or topic
   - USE DIVERSE TERMINOLOGY: Include both technical terms AND user-friendly alternatives
   - INCLUDE SEARCHABLE KEYWORDS: Begin with common terms a user might search for
   - BALANCE DETAIL LEVELS: Include both high-level descriptions and key technical details
   - LENGTH: Keep memories between 50-150 words
   - ALWAYS include the current date in YYYY-MM-DD format

3. MEMORY STORAGE PARAMETERS:
   - Use the "text" parameter for your formatted memory content
   - Set "source_type" to "llm_plugin"
   - Include appropriate "reference_data" with source information and context

4. REFERENCE DATA STRUCTURE:
   - source.platform: Identify your platform (e.g., "claude_desktop", "cline")
   - source.type: Always set to "llm_plugin"
   - source.version: Optional version information
   - context.conversation_id: Include when available to link related conversation memories
   - context.message_id: Optional identifier for the specific message

5. SPECIAL FORMATS:
   - For user facts, preferences, or personal details: "YYYY-MM-DD: FACT: [User] [specific preference/attribute/information]"
   - For reference materials: Include specific details about where to find the information

6. RELATED MEMORIES: After finding memories with search, check if there are related memories using the get_related_memories tool with the memory_id from search results. Present these additional memories to provide the user with more context.

7. RETRIEVAL CONSIDERATION: Before storing an important memory, consider: "What search terms might someone use to find this information later?" and ensure those terms are included.

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:

# View the current system prompt
cd <path-to-repository>
npm run prompt-helper -- view

# Reset to the default system prompt
cd <path-to-repository>
npm run prompt-helper -- reset

# Validate a custom system prompt
cd <path-to-repository>
npm run prompt-helper -- validate

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