engram · nickcirv — MCP-сервер для Claude Code: граф кода и контекст проекта
Индексирует структуру проекта и отдаёт агенту нужные файлы и связи вместо чтения всего подряд. Полезен, когда кодовая база перестала помещаться в контекст.
claude mcp add --env ENGRAM_API_TOKEN=<ENGRAM_API_TOKEN> --env ENGRAM_MISTAKE_GUARD=<ENGRAM_MISTAKE_GUARD> --env ENGRAM_ANTHROPIC_MEMORY_PATH=<ENGRAM_ANTHROPIC_MEMORY_PATH> --env ENGRAM_MCP_CONFIG_PATH=<ENGRAM_MCP_CONFIG_PATH> --env ENGRAM_NO_UPDATE_CHECK=<ENGRAM_NO_UPDATE_CHECK> --transport stdio nickcirv-engram -- npx -y engramxЧто делает engram
Engram строит локальный граф сущностей проекта: функции, ссылки между ними, общие изменения в Git и записанные ранее ошибки. Дальше агент спрашивает граф, получает ограниченный по токенам контекст и читает только то, что действительно нужно. Индексация кладёт данные в каталог .engram/ внутри проекта.
Работает через CLI, MCP, локальный дашборд с токеном и хуки. Хуки перехватывают чтение файлов и поиск по коду — поэтому по умолчанию init их ещё и устанавливает. Если хотите сначала посмотреть на граф, запускайте с --no-hook: так вы оцените выдачу до того, как менять поведение агента.
Для запуска нужен Node 20 или новее, пакет называется engramx. Система не полностью офлайновая: у CLI есть проверка обновлений npm, а подключённые провайдеры и плагины могут запускать свои процессы и ходить в сеть. Проверка отключается переменной ENGRAM_NO_UPDATE_CHECK=1. HTTP-сервер слушает 127.0.0.1, требует bearer-токен из ENGRAM_API_TOKEN или локального файла и проверяет Host/Origin.
Какие задачи решает
- найти нужный участок кода до чтения целых файлов
- посмотреть, кто вызывает функцию и что от неё зависит
- перенести разобранные ошибки в следующую сессию агента
- сгенерировать файлы правил для разных IDE из одного индекса
- оценить, сколько токенов уходит на контекст проекта
Примеры запросов агенту
- Найди в графе всё, что связано с авторизацией, и покажи только нужные файлы
- Построй граф проекта без установки хука, я хочу сначала посмотреть вывод
- Что изменится, если я трону эту функцию? Покажи вызывающий код
Как установить engram
Командой платформы
claude mcp add --env ENGRAM_API_TOKEN=<ENGRAM_API_TOKEN> --env ENGRAM_MISTAKE_GUARD=<ENGRAM_MISTAKE_GUARD> --env ENGRAM_ANTHROPIC_MEMORY_PATH=<ENGRAM_ANTHROPIC_MEMORY_PATH> --env ENGRAM_MCP_CONFIG_PATH=<ENGRAM_MCP_CONFIG_PATH> --env ENGRAM_NO_UPDATE_CHECK=<ENGRAM_NO_UPDATE_CHECK> --transport stdio nickcirv-engram -- npx -y engramxВместо <…> подставьте свои значения
Командой платформы
codex mcp add nickcirv-engram --env ENGRAM_API_TOKEN=<ENGRAM_API_TOKEN> --env ENGRAM_MISTAKE_GUARD=<ENGRAM_MISTAKE_GUARD> --env ENGRAM_ANTHROPIC_MEMORY_PATH=<ENGRAM_ANTHROPIC_MEMORY_PATH> --env ENGRAM_MCP_CONFIG_PATH=<ENGRAM_MCP_CONFIG_PATH> --env ENGRAM_NO_UPDATE_CHECK=<ENGRAM_NO_UPDATE_CHECK> -- npx -y engramxВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"nickcirv-engram": {
"command": "npx",
"args": [
"-y",
"engramx"
],
"env": {
"ENGRAM_API_TOKEN": "<ENGRAM_API_TOKEN>",
"ENGRAM_MISTAKE_GUARD": "<ENGRAM_MISTAKE_GUARD>",
"ENGRAM_ANTHROPIC_MEMORY_PATH": "<ENGRAM_ANTHROPIC_MEMORY_PATH>",
"ENGRAM_MCP_CONFIG_PATH": "<ENGRAM_MCP_CONFIG_PATH>",
"ENGRAM_NO_UPDATE_CHECK": "<ENGRAM_NO_UPDATE_CHECK>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"nickcirv-engram": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"engramx"
],
"env": {
"ENGRAM_API_TOKEN": "<ENGRAM_API_TOKEN>",
"ENGRAM_MISTAKE_GUARD": "<ENGRAM_MISTAKE_GUARD>",
"ENGRAM_ANTHROPIC_MEMORY_PATH": "<ENGRAM_ANTHROPIC_MEMORY_PATH>",
"ENGRAM_MCP_CONFIG_PATH": "<ENGRAM_MCP_CONFIG_PATH>",
"ENGRAM_NO_UPDATE_CHECK": "<ENGRAM_NO_UPDATE_CHECK>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ENGRAM_API_TOKEN=<ENGRAM_API_TOKEN> -e ENGRAM_MISTAKE_GUARD=<ENGRAM_MISTAKE_GUARD> -e ENGRAM_ANTHROPIC_MEMORY_PATH=<ENGRAM_ANTHROPIC_MEMORY_PATH> -e ENGRAM_MCP_CONFIG_PATH=<ENGRAM_MCP_CONFIG_PATH> -e ENGRAM_NO_UPDATE_CHECK=<ENGRAM_NO_UPDATE_CHECK> nickcirv-engram npx -y engramxВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о engram
Как установить engram в Claude Code?
Добавьте сервер командой claude mcp add engram -e ENGRAM_API_TOKEN=<ENGRAM_API_TOKEN> -- npx -y engramx. Второй вариант — с полным набором переменных: `claude mcp add --env ENGRAM_API_TOKEN=<ENGRAM_API_TOKEN> --env ENGRAM_MISTAKE_GUARD=<ENGRAM_MISTAKE_GUARD> --env ENGRAM_ANTHROPIC_MEMORY_PATH=<ENGRAM_ANTHROPIC_MEMORY_PATH> --env ENGRAM_MCP_CONFIG_PATH=<ENGRAM_MCP_CONFIG_PATH> --env ENGRAM_NO_UPDATE_CHECK=<ENGRAM_NO_UPDATE_CHECK> --transport stdio nickcirv-engram -- npx -y engramx`.
Что делает engram?
Собирает граф кода, связей в Git и записей об ошибках, а потом выдаёт агенту сжатый контекст по запросу. Граф хранится в SQLite через sql.js в каталоге .engram/ проекта.
Нужен ли токен для работы?
Да, для защищённых маршрутов HTTP-сервера и дашборда. Сервер берёт его из ENGRAM_API_TOKEN или локального файла с токеном.
Похожие MCP-серверы
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Сначала — engram от других авторов.
