engrava — MCP-сервер для Claude Code: что делает и как установить
MCP-сервер подключает базу долгосрочной памяти Engrava к AI-агенту. Даёт поиск через MindQL, полнотекстовый индекс и граф мыслей через протокол stdio.
claude mcp add --env ENGRAVA_DB_PATH=<ENGRAVA_DB_PATH> --env ENGRAVA_MCP_CONFIG=<ENGRAVA_MCP_CONFIG> --env ENGRAVA_MCP_READ_ONLY=<ENGRAVA_MCP_READ_ONLY> --transport stdio engrava -- uvx engrava-mcpЧто делает engrava
Сервер даёт агентам хранилище памяти Engrava на базе SQLite. В простом варианте достаточно указать путь к файлу через ENGRAVA_DB_PATH, но для векторного поиска потребуется ENGRAVA_MCP_CONFIG с файлом engrava.yaml. Без конфигурационного файла семантический поиск отключается, поэтому агенту остаются только полнотекстовые запросы и граф мыслей.
При запуске с переменной ENGRAVA_MCP_READ_ONLY сервер блокирует инструменты записи и обновление счётчиков обращений. При этом процессу всё равно нужны права на запись в файл базы при старте: сервер обязан проверить и обновить схему SQLite перед началом работы.
Какие задачи решает
- сохранять контекст и мысли агента в базе SQLite
- искать факты через MindQL и текстовый индекс
- связывать сущности и идеи в граф мыслей
- блокировать запись в память с помощью режима только для чтения
Примеры запросов агенту
- Сохрани текущие выводы по архитектуре в память Engrava
- Найди через MindQL прошлые решения по структуре базы данных
- Покажи связанные узлы графа для модуля авторизации
Как установить engrava
Командой платформы
claude mcp add --env ENGRAVA_DB_PATH=<ENGRAVA_DB_PATH> --env ENGRAVA_MCP_CONFIG=<ENGRAVA_MCP_CONFIG> --env ENGRAVA_MCP_READ_ONLY=<ENGRAVA_MCP_READ_ONLY> --transport stdio engrava -- uvx engrava-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from engrava-mcp <команда>
Командой платформы
codex mcp add engrava --env ENGRAVA_DB_PATH=<ENGRAVA_DB_PATH> --env ENGRAVA_MCP_CONFIG=<ENGRAVA_MCP_CONFIG> --env ENGRAVA_MCP_READ_ONLY=<ENGRAVA_MCP_READ_ONLY> -- uvx engrava-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from engrava-mcp <команда>
Файл настроек
{
"mcpServers": {
"engrava": {
"command": "uvx",
"args": [
"engrava-mcp"
],
"env": {
"ENGRAVA_DB_PATH": "<ENGRAVA_DB_PATH>",
"ENGRAVA_MCP_CONFIG": "<ENGRAVA_MCP_CONFIG>",
"ENGRAVA_MCP_READ_ONLY": "<ENGRAVA_MCP_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from engrava-mcp <команда>
Файл настроек
{
"servers": {
"engrava": {
"type": "stdio",
"command": "uvx",
"args": [
"engrava-mcp"
],
"env": {
"ENGRAVA_DB_PATH": "<ENGRAVA_DB_PATH>",
"ENGRAVA_MCP_CONFIG": "<ENGRAVA_MCP_CONFIG>",
"ENGRAVA_MCP_READ_ONLY": "<ENGRAVA_MCP_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from engrava-mcp <команда>
Командой платформы
gemini mcp add -e ENGRAVA_DB_PATH=<ENGRAVA_DB_PATH> -e ENGRAVA_MCP_CONFIG=<ENGRAVA_MCP_CONFIG> -e ENGRAVA_MCP_READ_ONLY=<ENGRAVA_MCP_READ_ONLY> engrava uvx engrava-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from engrava-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о engrava
Как установить engrava в Claude Code?
Выполните команду claude mcp add engrava -e ENGRAVA_DB_PATH=<ENGRAVA_DB_PATH> -- uvx engrava-mcp. Если используется файл конфигурации, передайте путь через ENGRAVA_MCP_CONFIG.
Что делает engrava?
Сервер открывает доступ к базе знаний Engrava по протоколу MCP. Ассистент получает возможность хранить мысли, строить связи в графе и выполнять поиск по накопленным записям.
Будет ли работать векторный поиск без engrava.yaml?
Нет, при передаче только пути к файлу базы данных через ENGRAVA_DB_PATH векторный поиск отключается. Модель эмбеддингов задаётся исключительно в файле engrava.yaml через переменную ENGRAVA_MCP_CONFIG.
