# Memory MCP: сервер, инструменты и настройка

> Memory - эталонный MCP-сервер @modelcontextprotocol/server-memory: память модели в виде графа знаний в локальном файле JSONL, девять инструментов, только stdio

Страница: https://mcpdoc.ru/servers/memory/
Указатель сайта: https://mcpdoc.ru/llms.txt

Memory хранит то, что модель узнала о пользователе, в виде графа знаний: сущности, связи между ними и наблюдения. Граф лежит в локальном файле JSONL. У сервера девять инструментов и один ресурс `memory://knowledge-graph`. Работает он только по stdio.

Редакцию протокола сервер не заявляет.

сверено с первичными источниками 4 октября 2026

Сведения о сервере поддерживается эталонный сервер проекта MCP

- **Кто выпускает:** Проект Model Context Protocol

- **Сторона:** сам владелец продукта

- **Где работает:** локально

- **Пакет:** @modelcontextprotocol/server-memory (npm)

- **Версия:** 2026.8.31, 2026-08-31

- **Транспорты:** stdio

- **Редакция протокола:** не заявлена

- **Проверено:** 2026-10-04

- **Источник:** [github.com](https://github.com/modelcontextprotocol/servers/tree/main/src/memory)

## Для чего он нужен

[README сервера](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/memory/README.md) называет его простой реализацией постоянной памяти на локальном графе знаний: с ним модель может помнить сведения о пользователе от разговора к разговору.

Проект относит Memory к эталонным реализациям. По [корневому README](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/README.md), это учебные примеры, а не готовые решения для промышленной эксплуатации.

## Как устроены данные

README описывает три понятия.

- **Сущность** - узел графа: уникальное имя, тип (например, человек или организация) и список наблюдений.
- **Связь** - направленное соединение двух сущностей с названием в действительном залоге, например `works_at`.
- **Наблюдение** - отдельный факт о сущности в виде строки. README советует хранить по одному факту в наблюдении.

## Запуск

```json title="Настройка клиента: Memory"
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}
```

Пример взят из документации выпуска 2026.8.31 и здесь не запускался.

## Инструменты

Имена сверены с [файлом `index.ts`](https://github.com/modelcontextprotocol/servers/blob/5abed86c5317b833dd59907492d56c65981642aa/src/memory/index.ts) и с опубликованным пакетом 2026.8.31: набор совпадает. Описания - по README.

| Инструмент | Что делает |
|---|---|
| `create_entities` | создаёт сущности; имена, которые уже есть, пропускает |
| `create_relations` | создаёт связи; повторы пропускает; не срабатывает, если одной из сущностей нет |
| `add_observations` | добавляет наблюдения к существующим сущностям; не срабатывает, если сущности нет |
| `delete_entities` | удаляет сущности вместе с их связями |
| `delete_observations` | удаляет указанные наблюдения |
| `delete_relations` | удаляет указанные связи |
| `read_graph` | возвращает весь граф |
| `search_nodes` | ищет по именам, типам и тексту наблюдений |
| `open_nodes` | возвращает сущности по именам и связи между ними; несуществующие имена пропускает |

Три инструмента удаления не возвращают ошибку, если удалять нечего: ответ сообщает, что не найдено или сколько удалено.

## Ресурс

| Ресурс | Адрес | Тип |
|---|---|---|
| `knowledge-graph` | `memory://knowledge-graph` | `application/json` |

Ресурс отдаёт весь граф в том же виде, что инструмент `read_graph`. По README, шесть изменяющих инструментов отправляют уведомление `notifications/resources/updated` для этого адреса, так что подписанный клиент видит изменения сразу.

Промптов сервер не объявляет. В README есть образец системного промпта для памяти, но это текст для ваших настроек, а не промпт MCP.

## Где лежат данные

| Переменная окружения | Назначение |
|---|---|
| `MEMORY_FILE_PATH` | путь к файлу JSONL с графом; по умолчанию `memory.jsonl` в каталоге сервера |

По умолчанию путь строится от каталога, где лежит сам код сервера (так написано в `index.ts`), а не от вашего рабочего каталога. Чтобы знать, где лежит память, и не потерять её при обновлении пакета, задайте `MEMORY_FILE_PATH` явно. Это практика, не правило MCP.

## Транспорт

Только stdio: в исходном коде используется один транспорт `StdioServerTransport`.

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

Раздела о безопасности в README сервера нет. В [базе советов по безопасности GitHub](https://github.com/advisories?query=%40modelcontextprotocol%2Fserver-memory) на 4 октября 2026 записей для этого пакета нет. Это не утверждение, что уязвимостей нет.

Что стоит учитывать по самому устройству сервера:

- граф хранится в обычном текстовом файле; о шифровании README не говорит;
- в память попадает то, что модель решила запомнить, включая личные сведения из разговора;
- всё, что записано в граф, модель потом читает как данные. Текст, попавший туда из недоверенного источника, вернётся в контекст в следующих разговорах.

## Редакция протокола

Сервер не заявляет, по какой редакции протокола он работает: ни README, ни исходный код её не называют.

В зависимостях опубликованного пакета 2026.8.31 стоит `@modelcontextprotocol/sdk ^1.30.0`. Это факт о пакете. Вывода о редакции протокола из него этот сайт не делает.

## Что читать дальше

- [Эталонные серверы](https://mcpdoc.ru/servers/overview/) - все семь серверов.
- [Resources](https://mcpdoc.ru/protocol/resources/) - как устроены ресурсы и подписка на них.
- [Угрозы](https://mcpdoc.ru/security/threats/) - чем опасны данные, которые возвращаются в контекст модели.
- [Как выбрать и проверить сервер](https://mcpdoc.ru/servers/choose/) - порядок проверки перед подключением.
