sqlite-graph-memory — MCP-сервер для Claude Code: как установить
Подключает долговременную память к агентам через локальные markdown-заметки. Сочетает векторный поиск по фрагментам с обходом связей [[wikilinks]] без отдельной графовой базы.
claude mcp add --env BRAIN_INDEX_DIR=<BRAIN_INDEX_DIR> --env TURNSTATE_DB=<TURNSTATE_DB> --transport stdio sqlite-graph-memory -- uvx sqlite-graph-memoryЧто делает sqlite-graph-memory
Сервер превращает локальную папку с markdown-файлами или хранилище Obsidian в долговременную память для ассистента. Сначала утилита sgm-index нарезает заметки на фрагменты и строит эмбеддинги e5-base. Во время поискового запроса скрипт находит первые совпадения по вектору, после чего собирает соседние документы по ссылкам формата [[wikilinks]] на глубину в один переход и переранжирует выдачу кросс-энкодером.
Граф связей не материализуется в виде отдельной таблицы: скрипт считывает ссылки прямо из текста заметок в момент выполнения запроса с лимитом до 40 соседних файлов. Вся постоянная информация сохраняется в единственный файл SQLite через стандартную библиотеку Python. Сервер требует заранее указать путь к готовому индексу в переменной BRAIN_INDEX_DIR, без неё инструмент не запустится.
Дополнительно предусмотрен хук завершения шага для агентов. Скрипт перехватывает хвост диалога после ответа ассистента и записывает сводку сессии, затронутые файлы и принятые решения в таблицу SQLite, не расходуя токены языковой модели.
Какие задачи решает
- находить связанные markdown-заметки по смыслу и синтаксису
[[wikilinks]] - сохранять контекст шагов агента в локальную базу данных SQLite
- переранжировать ассоциативную выдачу кросс-энкодером без отдельной графовой СУБД
- сравнивать качество векторной и графовой выдачи через встроенный режим
--ab
Примеры запросов агенту
- Найди в моих заметках всё, что связано с архитектурой проекта и зависимыми модулями.
- Что записано в заметках про Lanternfish и какие связанные документы на него ссылаются?
- Проверь историю сессий в базе данных и покажи принятые решения по рефакторингу.
Как установить sqlite-graph-memory
Командой платформы
claude mcp add --env BRAIN_INDEX_DIR=<BRAIN_INDEX_DIR> --env TURNSTATE_DB=<TURNSTATE_DB> --transport stdio sqlite-graph-memory -- uvx sqlite-graph-memoryВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sqlite-graph-memory <команда>
Командой платформы
codex mcp add sqlite-graph-memory --env BRAIN_INDEX_DIR=<BRAIN_INDEX_DIR> --env TURNSTATE_DB=<TURNSTATE_DB> -- uvx sqlite-graph-memoryВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sqlite-graph-memory <команда>
Файл настроек
{
"mcpServers": {
"sqlite-graph-memory": {
"command": "uvx",
"args": [
"sqlite-graph-memory"
],
"env": {
"BRAIN_INDEX_DIR": "<BRAIN_INDEX_DIR>",
"TURNSTATE_DB": "<TURNSTATE_DB>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sqlite-graph-memory <команда>
Файл настроек
{
"servers": {
"sqlite-graph-memory": {
"type": "stdio",
"command": "uvx",
"args": [
"sqlite-graph-memory"
],
"env": {
"BRAIN_INDEX_DIR": "<BRAIN_INDEX_DIR>",
"TURNSTATE_DB": "<TURNSTATE_DB>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sqlite-graph-memory <команда>
Командой платформы
gemini mcp add -e BRAIN_INDEX_DIR=<BRAIN_INDEX_DIR> -e TURNSTATE_DB=<TURNSTATE_DB> sqlite-graph-memory uvx sqlite-graph-memoryВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sqlite-graph-memory <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о sqlite-graph-memory
Как установить sqlite-graph-memory в Claude Code?
Выполните команду claude mcp add sqlite-graph-memory -e BRAIN_INDEX_DIR=<BRAIN_INDEX_DIR> -- uvx sqlite-graph-memory. Замените <BRAIN_INDEX_DIR> на путь к каталогу индекса, созданному через sgm-index.
Что делает sqlite-graph-memory?
Сервер организует ассоциативную память для ИИ-ассистентов по markdown-заметкам. Он находит отправные точки векторным поиском и подтягивает связанные страницы по ссылкам формата [[wikilinks]].
Нужна ли отдельная графовая база данных для работы?
Нет, внешняя графовая база не нужна. Связи извлекаются из файлов заметок прямо во время выполнения поискового запроса, а служебная информация пишется в локальный файл SQLite.
