Memory MCP

modelcontextprotocol/servers· Проверено 12.11.2026· 91,9 тыс.на GitHub

Даёт агенту долгую память между чатами: факты о людях, проектах и связях хранятся в локальном графе знаний. Второй вариант запоминает устройство кодовой базы: вызовы, зависимости, документацию.

2 реализации:

Память о вас и ваших делах: сущности, связи между ними и факты хранятся в одном файле JSONL.

Как подключить

Что сделать до подключения

Node.js 24 или новее; без Node.js есть образ Docker mcp/memory

Папка для файла памяти должна уже существовать: сервер создаёт только сам файл

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MEMORY_FILE_PATH=<полный путь>/memory.jsonl' --transport stdio memory \
  -- npx -y @modelcontextprotocol/server-memory

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.memory]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-memory"]

[mcp_servers.memory.env]
MEMORY_FILE_PATH = "<полный путь>/memory.jsonl"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "memory": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "memory": {
        "type": "local",
        "command": ["npx", "-y", "@modelcontextprotocol/server-memory"],
        "environment": {
          "MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"],
      "env": {
        "MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

create_entitiesсоздаёт сущности графа

create_relationsсвязывает сущности

add_observationsдописывает факты к сущности

delete_entitiesудаляет сущности со связями

delete_observationsудаляет отдельные факты

delete_relationsудаляет связи

read_graphчитает граф целиком

search_nodesищет по именам и фактам

open_nodesоткрывает сущности по именам

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

Как подключить

Что сделать до подключения

Поставить программу скриптом install.sh (macOS, Linux) или install.ps1 (Windows) из репозитория либо архивом со страницы релизов

Скрипт сам прописывает сервер в выбранных клиентах; вручную в command указывается полный путь к файлу программы

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio codebase-memory-mcp \
  -- /path/to/codebase-memory-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.codebase-memory-mcp]
command = "/path/to/codebase-memory-mcp"
args = []

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "codebase-memory-mcp": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "codebase-memory-mcp": {
      "type": "stdio",
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "codebase-memory-mcp": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "codebase-memory-mcp": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "codebase-memory-mcp": {
        "type": "local",
        "command": ["/path/to/codebase-memory-mcp"]
      }
    }
  }
}

{
  "mcpServers": {
    "codebase-memory-mcp": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "codebase-memory-mcp": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

Инструменты сервера

index_repositoryиндексирует репозиторий в граф

list_projectsпоказывает проиндексированные проекты

index_statusпроверяет состояние индекса

search_graphищет символы по графу

trace_pathпрослеживает вызовы и потоки данных

detect_changesоценивает, что задевает дифф

query_graphвыполняет запрос Cypher

get_graph_schemaописывает узлы и связи

compare_graphsсравнивает два снимка индекса

get_code_snippetчитает код функции

get_file_outlineпоказывает оглавление файла

get_architectureдаёт обзор устройства проекта

search_codeищет текст в файлах проекта

manage_adrведёт архитектурные решения

Показано 14 из 17.

Что попросить агента

«Запомни: я работаю в <компания>, отвечаю за <направление> и предпочитаю встречи утром»Агент вызовет create_entities для вас и компании, create_relations для связи и add_observations для предпочтений

«Что ты помнишь про <имя человека>?»Агент вызовет search_nodes по имени, затем open_nodes и перескажет факты и связи

«Забудь всё, что знаешь про <проект>»Агент вызовет delete_entities: сущность удалится вместе с фактами и связями

«Проиндексируй этот проект»Агент вызовет index_repository с полным путём к папке и затем index_status

«Что вызывает <имя функции>?»Агент вызовет trace_path с направлением inbound и опишет цепочку вызовов

Для каких задач

Запомнить ваши предпочтения, цели и людей вокруг и вспоминать их в новом чате

Связать людей, компании и события в граф и найти факт по слову

Найти в незнакомом проекте, где реализована функция и кто её вызывает

Оценить, какие места кода заденет текущий дифф

Проследить, что запускает и разворачивает задача CI, скрипт или правило Make

Ограничения

Memory Server входит в набор эталонных реализаций протокола — учебных примеров, которые для продакшена не готовы

Без MEMORY_FILE_PATH граф лежит в папке пакета внутри node_modules: обновление сервера или очистка кэша npx удаляет память

Что и как часто запоминать, модель решает по системному промпту: инструкцию под свою задачу нужно написать самому

У codebase-memory-mcp автоиндексация выключена по умолчанию: проект индексируют вызовом index_repository, а папки вне git потом не отслеживаются

Если не работает

После обновления сервера память пустая

Граф лежал в папке пакета внутри node_modules. Задайте MEMORY_FILE_PATH с полным путём в своей папке и перенесите туда старый файл memory.jsonl.

Запись в память падает с ошибкой через 60 секунд

Другой процесс держит файл блокировки <файл памяти>.lock. Брошенная блокировка снимается сама через 30 секунд; на сетевой файловой системе общий файл памяти держать нельзя.

В Docker сервер не сохраняет граф и пишет EACCES

Том создан старым образом от root. Обновите код в томе командой из инструкции с --user root и chown для пользователя node.

index_repository отваливается по таймауту клиента

Запустите индексацию с async: true и проверяйте ход вызовом с status: true. На любой ошибке индексации передавайте полный путь к папке.

В /mcp нет codebase-memory-mcp

Проверьте, что в конфиге указан полный путь к программе, и перезапустите агента. Если программа не находится после установки, добавьте ~/.local/bin в PATH.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Knowledge Graph Memory Serverразработчик сервиса	Model Context Protocol	91,9 тыс.	локально	не нужен	9	12 ноября 2026
codebase-memory-mcp	DeusData	48,6 тыс.	локально	не нужен	17	11 ноября 2026

Частые вопросы

Где хранится память?

В файле memory.jsonl. Задайте путь переменной MEMORY_FILE_PATH, например ~/memory.jsonl: путь по умолчанию находится внутри node_modules и пропадает при обновлении. В Docker файл живёт в томе claude-memory.

Можно подключить одну память к двум клиентам?

Да, укажите обоим один MEMORY_FILE_PATH. Каждая запись берёт файл блокировки, поэтому процессы пишут по очереди и ничего не теряют. На сетевом диске такая блокировка может не сработать.

Как заставить агента пользоваться памятью?

Добавьте инструкцию в системный промпт или в инструкции проекта Claude.ai: в начале чата доставать всё нужное из памяти, а новые факты о людях, целях и предпочтениях сохранять сущностями, связями и наблюдениями.

Чем Memory отличается от codebase-memory-mcp?

Memory хранит то, что агент узнал из разговора с вами. codebase-memory-mcp строит граф по исходникам проекта: функции, вызовы, маршруты, конфиги Docker и Kubernetes. Их можно подключить вместе.

Сколько ресурсов нужно codebase-memory-mcp?

Индексы хранятся в SQLite в ~/.cache/codebase-memory-mcp. Ядро Linux индексируется за 3 минуты на Apple M3 Pro, Django — примерно за 6 секунд. Сброс — удалить эту папку.

Работает ли сервер из России?

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

Memory MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы