Servidor de memoria de gráficos de conocimiento

Una implementación básica de memoria persistente mediante un grafo de conocimiento local. Esto permite a Claude recordar información sobre el usuario en todos los chats.

Conceptos básicos

Entidades

Las entidades son los nodos principales del grafo de conocimiento. Cada entidad tiene:

• Un nombre único (identificador)

• Un tipo de entidad (por ejemplo, "persona", "organización", "evento")

• Una lista de observaciones

Ejemplo:

Relaciones

Las relaciones definen conexiones dirigidas entre entidades. Siempre se almacenan en voz activa y describen cómo las entidades interactúan o se relacionan entre sí.

Ejemplo:

Observaciones

Las observaciones son fragmentos discretos de información sobre una entidad. Son:

• Almacenados como cadenas

• Adjunto a entidades específicas

• Se puede agregar o quitar de forma independiente.

• Debe ser atómico (un hecho por observación)

Ejemplo:

API

Herramientas

• crear_entidades

  • Crear múltiples entidades nuevas en el gráfico de conocimiento

  • Entrada: entities (matriz de objetos)

    • Cada objeto contiene:

      • name (cadena): identificador de entidad

      • entityType (cadena): clasificación de tipos

      • observations (string[]): Observaciones asociadas

  • Ignora entidades con nombres existentes

• crear_relaciones

  • Crear múltiples relaciones nuevas entre entidades

  • Entrada: relations (matriz de objetos)

    • Cada objeto contiene:

      • from (string): Nombre de la entidad de origen

      • to (cadena): nombre de la entidad de destino

      • relationType (cadena): Tipo de relación en voz activa

  • Omite relaciones duplicadas

• añadir_observaciones

  • Agregar nuevas observaciones a entidades existentes

  • Entrada: observations (matriz de objetos)

    • Cada objeto contiene:

      • entityName (cadena): entidad de destino

      • contents (string[]): Nuevas observaciones para agregar

  • Devuelve observaciones agregadas por entidad

  • Falla si la entidad no existe

• eliminar_entidades

  • Eliminar entidades y sus relaciones

  • Entrada: entityNames (cadena[])

  • Eliminación en cascada de relaciones asociadas

  • Operación silenciosa si la entidad no existe

• eliminar_observaciones

  • Eliminar observaciones específicas de las entidades

  • Entrada: deletions (matriz de objetos)

    • Cada objeto contiene:

      • entityName (cadena): entidad de destino

      • observations (string[]): Observaciones para eliminar

  • Funcionamiento silencioso si no existe observación

• eliminar_relaciones

  • Eliminar relaciones específicas del gráfico

  • Entrada: relations (matriz de objetos)

    • Cada objeto contiene:

      • from (string): Nombre de la entidad de origen

      • to (cadena): nombre de la entidad de destino

      • relationType (cadena): tipo de relación

  • Operación silenciosa si no existe relación

• leer_gráfico

  • Lea el gráfico de conocimiento completo

  • No se requiere entrada

  • Devuelve la estructura gráfica completa con todas las entidades y relaciones

• nodos de búsqueda

  • Búsqueda de nodos según la consulta

  • Entrada: query (cadena)

  • Búsquedas en:

    • Nombres de entidades

    • Tipos de entidad

    • Contenido de la observación

  • Devuelve entidades coincidentes y sus relaciones.

• nodos abiertos

  • Recuperar nodos específicos por nombre

  • Entrada: names (cadena[])

  • Devoluciones:

    • Entidades solicitadas

    • Relaciones entre las entidades solicitadas

  • Omite silenciosamente nodos inexistentes

Uso con Claude Desktop

Configuración

Agregue esto a su claude_desktop_config.json:

Estibador

NPX

NPX con configuración personalizada

El servidor se puede configurar utilizando las siguientes variables de entorno:

• MEMORY_FILE_PATH : Ruta al archivo JSON de almacenamiento de memoria (predeterminado: memory.json en el directorio del servidor)

Instrucciones de instalación de VS Code

Para una instalación rápida, utilice uno de los botones de instalación de un solo clic que aparecen a continuación:

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Para ello, presione Ctrl + Shift + P y escriba Preferences: Open Settings (JSON) .

Opcionalmente, puede agregarlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otros.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json .

NPX

Estibador

Indicador del sistema

El indicador para utilizar la memoria depende del caso de uso. Cambiarlo ayudará al modelo a determinar la frecuencia y los tipos de memorias creadas.

Aquí tienes un ejemplo de mensaje para personalizar el chat. Puedes usarlo en el campo "Instrucciones personalizadas" de un proyecto de Claude.ai .

Edificio

Estibador:

Licencia

Este servidor MCP cuenta con la licencia MIT. Esto significa que puede usar, modificar y distribuir el software libremente, sujeto a los términos y condiciones de la licencia MIT. Para más detalles, consulte el archivo de LICENCIA en el repositorio del proyecto.