Servidor MCP de memoria

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona herramientas para almacenar, recuperar y administrar memorias guardadas en un archivo local.

Características

• Almacene recuerdos de texto con etiquetas opcionales
• Buscar recuerdos por texto o etiquetas
• Recuperar todos los recuerdos almacenados
• Eliminar recuerdos específicos
• Ver estadísticas de uso de etiquetas
• Almacenamiento persistente en un archivo JSON local

Instalación

De la fuente

1. Clonar este repositorio
2. Instalar dependencias:
   npm install
3. Construir el servidor:
   npm run build

Uso

Ejecución del servidor

Ejecute el servidor con:

Donde storage-path es el directorio donde desea almacenar el archivo de memorias (por defecto, el directorio actual).

Configuración con Claude para escritorio

Para utilizar este servidor con Claude for Desktop:

1. Abra el archivo de configuración de Claude for Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
2. Agregue la configuración del servidor:

3. Reinicie Claude para escritorio. Es posible que deba forzar el cierre de cualquier proceso de Claude en ejecución para que los cambios surtan efecto.

Herramientas disponibles

El servidor expone las siguientes herramientas:

store-memory

Almacena una nueva memoria.

Parámetros:

• content (cadena, obligatorio): el contenido de texto que se almacenará
• tags (matriz de cadenas, opcional): etiquetas para categorizar la memoria

search-memories

Búsqueda de recuerdos.

Parámetros:

• searchTerm (cadena, opcional): Texto a buscar en el contenido de la memoria
• tag (cadena, opcional): Filtrar recuerdos por esta etiqueta

get-all-memories

Recupera todos los recuerdos almacenados.

Parámetros: Ninguno

delete-memory

Elimina una memoria por ID.

Parámetros:

• id (cadena, obligatoria): ID de la memoria a eliminar

get-tags-summary

Obtiene un resumen de todas las etiquetas utilizadas.

Parámetros: Ninguno

Ejemplo de uso en Claude

A continuación se muestran algunos ejemplos de consultas para utilizar con Claude:

• Guarde esta información: La fecha límite del proyecto es el 15 de marzo de 2025. Etiquetas: trabajo, plazos
• ¿Qué recuerdos tengo relacionados con el trabajo?
• "Muéstrame todos mis recuerdos"
• "Eliminar memoria con ID abc123"
• ¿Qué etiquetas he utilizado en mis recuerdos?

Estructura de archivos

El servidor almacena memorias en un archivo llamado memories.json en el directorio de almacenamiento especificado.

Licencia

Instituto Tecnológico de Massachusetts (MIT)