Engram MCP
Локальный граф кода и контекст для агентов: сущности, связи Git и записанные ошибки отдаются через консоль, хуки и MCP
- 143 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Установка хуков и генераторов меняет файлы проекта и настройки клиента
- Контекст из графа уходит модели агента, так что учитывайте политику ее провайдера
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/nickcirv-engramОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установка хуков и генераторов меняет файлы проекта и настройки клиента
- Контекст из графа уходит модели агента, так что учитывайте политику ее провайдера
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Engram индексирует сущности исходного кода, связи из Git и выбранную память проекта, а затем отдает ограниченный по объему контекст. Граф лежит в локальной базе SQLite внутри каталога `.engram/` проекта, обращаться к нему можно из консоли, из хуков агента, через MCP и в защищенной локальной панели. Запросы консоли: `query` ищет по графу, `path` строит кратчайший путь, `gods` выводит самые связанные узлы, `callers` и `callees` показывают вызовы, `impact` оценивает влияние правки, а `learn` и `mistakes` ведут память об ошибках. Для MCP есть исполняемый файл `engram-serve` с инструментами `query_graph`, `god_nodes`, `graph_stats`, `shortest_path`, `benchmark` и `list_mistakes`. Генераторы `gen`, `gen-mdc`, `gen-aider`, `gen-windsurfrules` и `gen-ccs` готовят документы для Claude, Cursor, Aider и Windsurf.
Для кого. Разработчикам, которые ведут работу с агентами по большому репозиторию и хотят вернуть в новую сессию уже записанные ошибки и связи кода.
Подходит, если
- Нужно найти код, связанный с авторизацией, до чтения файлов целиком, с бюджетом токенов на ответ
- Хочется, чтобы ошибки прошлой сессии попадали в следующую через `mistakes`
- Нужно оценить, что заденет правка, через `impact`, `callers` и `callees`
- Для проекта нужны сгенерированные правила под Cursor, Aider или Windsurf из одного графа
Не подходит, если
- Нужен готовый пакет без сборки: в README описана сборка из исходников на закрепленном коммите
- Нужны гарантии работы без сети: проверки обновлений и внешние поставщики могут обращаться в сеть
- Проект небольшой, и хватает поиска, встроенного в агента
Пример запроса к агенту
Проиндексируй проект, найди узлы, связанные с авторизацией, покажи вызывающие функции и ошибки из прошлых сессий, уложись в 2000 токеновMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Переменные окружения
ENGRAM_NO_UPDATE_CHECK- Значение 1 отключает проверку обновлений npm.
ENGRAM_API_TOKENсекрет- Токен HTTP-сервера, иначе берется из локального файла.
Ограничения
В тексте указана проверенная по исходникам версия `engramx` 4.5.0 на Node 20 и новее и сборку с закрепленного коммита, выпущенного пакета в тексте нет. Сборка идет с `npm install --ignore-scripts`, а `init` по умолчанию ставит хук Sentinel, поэтому для первого знакомства используйте `--no-hook`. Граф локальный, но система целиком не обязана быть без сети: есть проверка обновлений npm, внешний вызов Context7 и поставщики через MCP или плагины, переменная `ENGRAM_NO_UPDATE_CHECK=1` отключает только проверку обновлений. HTTP-сервер слушает `127.0.0.1` и требует токен. Генераторы, установка хуков и команды кэша меняют локальное состояние.
Как отключить. Выполните `hook-disable` или удалите хук, уберите регистрацию `engram` из клиента и каталог `.engram/` в проекте.
Частые вопросы
Как подключить MCP-сервер?
Пропишите команду `node` с аргументами `/absolute/path/to/engram/dist/serve.js` и абсолютный путь к проекту. Сервер отдает `query_graph`, `god_nodes`, `graph_stats`, `shortest_path`, `benchmark` и `list_mistakes`.
Где хранится граф?
В локальной базе SQLite внутри каталога `.engram/` проекта, граф строится командами `init` и `reindex`.
Ставит ли `init` хук?
По умолчанию да, хук Sentinel. Флаг `--no-hook` пропускает установку, а `install-hook --dry-run` показывает действия заранее.
Работает ли Engram без сети?
Ядро графа локальное, но проверка обновлений npm и внешние поставщики могут ходить в сеть. Проверку обновлений отключает `ENGRAM_NO_UPDATE_CHECK=1`.
Как защищен локальный HTTP-сервер?
Он слушает `127.0.0.1`, проверяет заголовки Host и Origin и требует токен из `ENGRAM_API_TOKEN` или локального файла.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный граф кода для агентов: MCP-сервер отдает точки входа, связи символов и радиус влияния изменений за один вызов
Граф кода и память проекта в одной программе на Rust: агент получает выдержки из файлов со ссылкой на строки
GraphMind
graphmind
Локальный MCP-сервер строит граф кода и хранит память о решениях проекта, так что агент не перечитывает репозиторий каждую сессию
Context Engine — поиск по коду и память для агента
Context Engine
Скилл учит агента сначала обращаться к индексу кода и графу символов Context Engine и только потом читать файлы напрямую
CodeGraph на Rust
codegraph-rust
Граф кода для агента на Rust: четыре MCP-инструмента показывают, что заденет правка, как устроена архитектура и где хрупкие места проекта
Локальный граф структуры кода: строит карту репозитория через tree-sitter и отдает агенту по MCP только тот контекст, который относится к правке
Коротко о README
Текст описывает Engram как граф кода и набор контекста для агентов, затем идут быстрый старт со сборкой из исходников и проверкой запроса, таблица реализованных возможностей, архитектура и границы приватности. Предупреждения касаются сети, хуков и локального токена.