Сервер памяти графа знаний

Базовая реализация постоянной памяти с использованием локального графа знаний. Это позволяет Клоду запоминать информацию о пользователе в чатах.

Основные концепции

Сущности

Сущности являются основными узлами в графе знаний. Каждая сущность имеет:

• Уникальное имя (идентификатор)

• Тип сущности (например, «лицо», «организация», «событие»)

• Список наблюдений

Пример:

Отношения

Отношения определяют направленные связи между сущностями. Они всегда хранятся в активном залоге и описывают, как сущности взаимодействуют или относятся друг к другу.

Пример:

Наблюдения

Наблюдения — это отдельные фрагменты информации о сущности. Они:

• Сохраняется как строки

• Прикреплено к определенным субъектам

• Могут быть добавлены или удалены независимо друг от друга.

• Должен быть атомарным (один факт на наблюдение)

Пример:

API

Инструменты

• создать_сущности

  • Создайте несколько новых сущностей в графе знаний

  • Входные данные: entities (массив объектов)

    • Каждый объект содержит:

      • name (строка): Идентификатор сущности

      • entityType (строка): Классификация типов

      • observations (string[]): Связанные наблюдения

  • Игнорирует сущности с существующими именами

• создать_отношения

  • Создать несколько новых отношений между сущностями

  • Вход: relations (массив объектов)

    • Каждый объект содержит:

      • from (string): Имя исходной сущности

      • to (строка): Имя целевого объекта

      • relationType (строка): Тип отношений в активном залоге

  • Пропускает дублирующиеся отношения

• добавить_наблюдения

  • Добавить новые наблюдения к существующим сущностям

  • Вход: observations (массив объектов)

    • Каждый объект содержит:

      • entityName (строка): Целевая сущность

      • contents (string[]): Новые наблюдения для добавления

  • Возвращает добавленные наблюдения для каждой сущности

  • Не удается, если объект не существует

• удалить_сущности

  • Удалить сущности и их связи

  • Ввод: entityNames (string[])

  • Каскадное удаление связанных отношений

  • Тихая операция, если объект не существует

• удалить_наблюдения

  • Удалить определенные наблюдения из сущностей

  • Вход: deletions (массив объектов)

    • Каждый объект содержит:

      • entityName (строка): Целевая сущность

      • observations (string[]): Наблюдения для удаления

  • Бесшумная работа, если нет наблюдения

• удалить_отношения

  • Удалить определенные отношения из графика

  • Вход: relations (массив объектов)

    • Каждый объект содержит:

      • from (string): Имя исходной сущности

      • to (строка): Имя целевого объекта

      • relationType (строка): Тип отношения

  • Тихая операция, если связь не существует

• читать_граф

  • Прочитать всю схему знаний

  • Ввод не требуется

  • Возвращает полную структуру графа со всеми сущностями и отношениями

• поисковые_узлы

  • Поиск узлов на основе запроса

  • Ввод: query (строка)

  • Поиск по:

    • Имена сущностей

    • Типы сущностей

    • Содержание наблюдения

  • Возвращает соответствующие сущности и их отношения

• открытые_узлы

  • Извлечь определенные узлы по имени

  • Ввод: names (string[])

  • Возврат:

    • Запрошенные сущности

    • Отношения между запрашиваемыми субъектами

  • Пропускает несуществующие узлы без уведомления

Использование с Claude Desktop

Настраивать

Добавьте это в ваш claude_desktop_config.json:

Докер

НПХ

NPX с пользовательской настройкой

Сервер можно настроить с помощью следующих переменных среды:

• MEMORY_FILE_PATH : Путь к файлу JSON хранилища памяти (по умолчанию: memory.json в каталоге сервера)

Инструкции по установке VS Code

Для быстрой установки воспользуйтесь одной из кнопок установки в один клик ниже:

Для ручной установки добавьте следующий блок JSON в файл настроек пользователя (JSON) в VS Code. Это можно сделать, нажав Ctrl + Shift + P и введя Preferences: Open Settings (JSON) .

При желании вы можете добавить его в файл .vscode/mcp.json в вашем рабочем пространстве. Это позволит вам поделиться конфигурацией с другими.

Обратите внимание, что ключ mcp не нужен в файле .vscode/mcp.json .

НПХ

Докер

Системная подсказка

Запрос на использование памяти зависит от варианта использования. Изменение запроса поможет модели определить частоту и типы создаваемых воспоминаний.

Вот пример подсказки для персонализации чата. Вы можете использовать эту подсказку в поле "Custom Instructions" проекта Claude.ai .

Здание

Докер:

Лицензия

Этот сервер MCP лицензирован по лицензии MIT. Это означает, что вы можете свободно использовать, изменять и распространять программное обеспечение в соответствии с условиями лицензии MIT. Для получения более подробной информации см. файл LICENSE в репозитории проекта.