Memory Server

MCP-сервер для персистентной памяти на основе графа знаний — сохранение информации о пользователе между сессиями

Memory Server реализует персистентную память с помощью локального графа знаний. Позволяет Claude запоминать информацию о пользователе между чатами, создавая долговременные воспоминания.

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

Сущности (Entities)

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

name — уникальный идентификатор
entityType — тип (person, organization, event и т.д.)
observations — список наблюдений

{
  "name": "John_Smith",
  "entityType": "person",
  "observations": ["Говорит по-испански", "Работает в Anthropic"]
}

Отношения (Relations)

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

{
  "from": "John_Smith",
  "to": "Anthropic",
  "relationType": "works_at"
}

Наблюдения (Observations)

Наблюдения — дискретные факты о сущности:

Хранятся как строки
Привязаны к конкретным сущностям
Могут добавляться и удаляться независимо
Должны быть атомарными (один факт на наблюдение)

{
  "entityName": "John_Smith",
  "observations": [
    "Говорит по-испански",
    "Закончил университет в 2019",
    "Предпочитает утренние встречи"
  ]
}

npx -y @modelcontextprotocol/server-memory

docker run -i -v claude-memory:/app/dist --rm mcp/memory

Инструменты

create_entities

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

Параметр	Тип	Описание
`entities`	array	Массив объектов сущностей

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

name (string) — идентификатор сущности
entityType (string) — тип сущности
observations (string[]) — начальные наблюдения

create_relations

Создаёт отношения между сущностями.

Параметр	Тип	Описание
`relations`	array	Массив объектов отношений

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

from (string) — исходная сущность
to (string) — целевая сущность
relationType (string) — тип отношения (в активном залоге)

add_observations

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

Параметр	Тип	Описание
`observations`	array	Массив объектов наблюдений

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

entityName (string) — целевая сущность
contents (string[]) — новые наблюдения

Возвращает: добавленные наблюдения по сущностям.

delete_entities

Удаляет сущности и связанные отношения.

Параметр	Тип	Описание
`entityNames`	string[]	Имена сущностей для удаления

delete_observations

Удаляет конкретные наблюдения из сущностей.

Параметр	Тип	Описание
`deletions`	array	Массив объектов удаления

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

entityName (string) — целевая сущность
observations (string[]) — наблюдения для удаления

delete_relations

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

Параметр	Тип	Описание
`relations`	array	Массив объектов отношений

read_graph

Читает весь граф знаний. Параметров не требует.

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

search_nodes

Поиск узлов по запросу.

Параметр	Тип	Описание
`query`	string	Поисковый запрос

Ищет по:

Именам сущностей
Типам сущностей
Содержимому наблюдений

Возвращает: найденные сущности и их отношения.

open_nodes

Получает конкретные узлы по именам.

Параметр	Тип	Описание
`names`	string[]	Массив имён сущностей

Возвращает:

Запрошенные сущности
Отношения между ними

Конфигурация

Claude Desktop

NPX
Docker

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

{
  "mcpServers": {
    "memory": {
      "command": "docker",
      "args": [
        "run", "-i",
        "-v", "claude-memory:/app/dist",
        "--rm", "mcp/memory"
      ]
    }
  }
}

Кастомный путь к файлу памяти

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "/path/to/custom/memory.jsonl"
      }
    }
  }
}

По умолчанию файл памяти: memory.jsonl в директории сервера.

VS Code

NPX
Docker

{
  "servers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

{
  "servers": {
    "memory": {
      "command": "docker",
      "args": [
        "run", "-i",
        "-v", "claude-memory:/app/dist",
        "--rm", "mcp/memory"
      ]
    }
  }
}

Системный промпт

Для эффективного использования памяти добавьте в системный промпт (например, в “Custom Instructions” проекта Claude):

Следуйте этим шагам для каждого взаимодействия:

1. Идентификация пользователя:
   - Предполагайте, что вы общаетесь с default_user
   - Если пользователь не идентифицирован, попробуйте его определить

2. Извлечение памяти:
   - Всегда начинайте чат со слова "Вспоминаю..." и извлекайте
     всю релевантную информацию из графа знаний
   - Называйте граф знаний "памятью"

3. Память:
   - Во время разговора отслеживайте новую информацию в категориях:
     a) Базовая идентичность (возраст, пол, локация, работа, образование)
     b) Поведение (интересы, привычки)
     c) Предпочтения (стиль общения, язык)
     d) Цели (цели, стремления)
     e) Отношения (личные и профессиональные связи)

4. Обновление памяти:
   - Если получена новая информация, обновите память:
     a) Создайте сущности для организаций, людей, событий
     b) Свяжите их с существующими сущностями
     c) Сохраните факты как наблюдения

Примеры использования

Создание сущности

{
  "name": "create_entities",
  "arguments": {
    "entities": [
      {
        "name": "Иван_Петров",
        "entityType": "person",
        "observations": [
          "Разработчик Python",
          "Живёт в Москве"
        ]
      },
      {
        "name": "TechCorp",
        "entityType": "organization",
        "observations": ["IT-компания"]
      }
    ]
  }
}

Создание отношения

{
  "name": "create_relations",
  "arguments": {
    "relations": [
      {
        "from": "Иван_Петров",
        "to": "TechCorp",
        "relationType": "работает_в"
      }
    ]
  }
}

Поиск информации

{
  "name": "search_nodes",
  "arguments": {
    "query": "разработчик"
  }
}

Сборка Docker-образа

docker build -t mcp/memory -f src/memory/Dockerfile .

Memory Server

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

Сущности (Entities)

Отношения (Relations)

Наблюдения (Observations)

Установка

Инструменты

create_entities

create_relations

add_observations

delete_entities

delete_observations

delete_relations

read_graph

search_nodes

open_nodes

Конфигурация

Claude Desktop

Кастомный путь к файлу памяти

VS Code

Системный промпт

Примеры использования

Создание сущности

Создание отношения

Поиск информации

Сборка Docker-образа

Ссылки

Начало работы

SDK по языкам

Эталонные серверы

Развёртывание

Оптимизация

Безопасность

Примеры

Справочник