engrim

engrim — MCP-сервер сообщества (автор — timgordontg). Локальная эпизодическая память для Claude Code, Cursor и Codex. Ставится через pip. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
timgordontg
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
linux, macos, windows
Языки
python

Уровень риска: high

Хранит память и журнал сессий в ~/.engrim/memory.db; engrim setup меняет хуки, конфиги MCP и файлы инструкций агентов.

Настройка клиентов

codex
{
    "code": "engrim setup --codex-mcp\n# Equivalent: engrim setup --codex --codex-mcp",
    "lang": "bash",
    "notes": "Команда настройки из README; MCP для Codex подключается отдельно",
    "verified": "docs"
}

Что умеет

engrim — локальная эпизодическая память для ИИ-агентов программиста под лицензией MIT. Это хранилище на SQLite, привязанное к проекту, которое позволяет переключаться между Google Antigravity, Claude Code, Cursor, Codex CLI, GitHub Copilot CLI, OpenCode и Windsurf на одной кодовой базе, не теряя принятых решений.

Идея проекта: вместо того чтобы на каждом шаге заново отправлять модели огромную историю переписки, engrim подставляет в начало сессии компактный пакет памяти примерно на 4000 символов (меньше 1000 токенов) с отметкой, откуда продолжить. Поэтому чат можно очищать командой /clear в любой момент — решения и текущее состояние загрузятся снова.

Как это работает:

  • загрузка: при старте агента в контекст попадает пакет самых важных записей;
  • запись: агент сохраняет архитектурные решения через MCP (engrim_add) или автоматически через хуки, с отметкой, какой агент их сделал;
  • поиск: гибридный поиск по ключевым словам (BM25) и векторам (model2vec) находит нужные записи примерно за 30 мс;
  • журнал: реплики сессий записываются в локальный журнал, чтобы перед очисткой проверить, не остались ли решения несохранёнными.

MCP-сервер даёт четыре инструмента: engrim_recall (поиск по памяти проекта), engrim_add (запись), engrim_context (пакет памяти для старта сессии) и engrim_review (проверка несохранённых решений перед очисткой).

Кому подойдёт

  • Разработчикам, которые пользуются несколькими агентами и хотят, чтобы решения из Claude Code были видны в Cursor или Codex.
  • Тем, кто экономит токены и часто очищает контекст в длинных сессиях.

Похожие серверы — в категории знания и память.

Установка

Нужен Python 3.10+:

pip install engrim

Команда engrim setup без аргументов сама находит установленные среды и настраивает их: хуки, MCP-сервер и заметки для агентов. Флаг --dry-run показывает изменения без записи на диск. Команда engrim doctor --fix проверяет хуки и конфиги MCP и чинит устаревшие пути. Сам сервер запускается командой engrim serve --mcp.

Подключение к клиентам

Конфиг и команды приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "engrim": {
      "command": "engrim",
      "args": ["serve", "--mcp"]
    }
  }
}

Для Windsurf конфиг добавляют в ~/.codeium/windsurf/mcp_config.json. Для Cursor команда добавляет сервер в ~/.cursor/mcp.json. Для Codex MCP подключается отдельно через codex mcp add, а хуки нужно одобрить командой /hooks. Для OpenCode ставится плагин, а сервер регистрируется в ~/.config/opencode/opencode.json. Для Claude Code engrim setup --claude настраивает хуки сессий и строку состояния.

Проверка

После настройки откройте новую сессию агента: в начале контекста должен появиться пакет памяти. Попросите агента записать решение через engrim_add, затем очистите чат и спросите о нём.

Примеры задач

Запиши решение: все даты в API храним в UTC, а в интерфейсе показываем в часовом поясе пользователя.
Перед очисткой контекста проверь, остались ли несохранённые решения.

Риски

  • Запись на диск и в конфиги. engrim хранит память в ~/.engrim/memory.db, а engrim setup меняет настройки агентов: хуки, конфиги MCP, файлы с инструкциями вроде CLAUDE.md и AGENTS.md. Сначала запустите с --dry-run.
  • Журнал сессий. Реплики сессий записываются в локальный журнал. Не обсуждайте с агентом секреты, если не хотите, чтобы они сохранились.
  • Хуки. Хуки выполняют команды engrim при каждом старте и завершении сессии; проверьте их перед одобрением.
  • Приватность. Данные хранятся только локально: без телеметрии и синхронизации, файл базы доступен только владельцу и по умолчанию исключён из Git.

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

Нужна ли видеокарта или облако?

Нет. Векторы считаются на процессоре, а с ENGRIM_EMBED=off поиск работает только по ключевым словам без дополнительных зависимостей.

Как удалить engrim из Codex?

Команда engrim uninstall --codex удаляет только хуки, блок инструкций и запись MCP-сервера engrim, остальные настройки не трогает.

Основы протокола — на странице что такое MCP-сервер.

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

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники