ai-memory — MCP-сервер для Claude Code: что делает и как установить
Сервер долговременной памяти для ИИ-ассистентов. Сохраняет архитектурные решения и правки в локальной базе данных, расходуя токены только при поиске.
claude mcp add --env AI_MEMORY_DB=<AI_MEMORY_DB> --transport stdio ai-memory -- docker run -i --rm -e AI_MEMORY_DB ghcr.io/alphaonedev/ai-memory:0.5.1Что делает ai-memory
ai-memory подключает к ассистенту хранилище на базе SQLite с полнотекстовым индексом FTS5. При повторных запросах сервер ранжирует записи по релевантности и переносит ключевые факты в постоянную память. Данные не висят в контекстном окне постоянно, поэтому токены модели тратятся только во время явного поиска.
Для крупных инсталляций поддерживается связка PostgreSQL и Apache AGE с графовым представлением связей. В версии 0.9.0 прямые запросы записи через HTTP требуют аттестации агента, тогда как стандартные вызовы через MCP остаются доступными в обычном режиме. Для запуска через Docker обязательно передать переменную окружения с путём к базе AI_MEMORY_DB.
Какие задачи решает
- переносить архитектурные договорённости между сессиями кодинга
- искать прошлые исправления через полнотекстовый индекс
- сохранять проектные правила без раздувания контекстного окна
- подключать общую базу знаний к разным агентам через единый протокол
Примеры запросов агенту
- Вспомни, как мы договаривались обрабатывать ошибки в API
- Сохрани в память архитектурное решение по структуре модулей
- Найди в контексте прошлые замечания по миграциям базы
Как установить ai-memory
Командой платформы
claude mcp add --env AI_MEMORY_DB=<AI_MEMORY_DB> --transport stdio ai-memory -- docker run -i --rm -e AI_MEMORY_DB ghcr.io/alphaonedev/ai-memory:0.5.1Вместо <…> подставьте свои значения
Командой платформы
codex mcp add ai-memory --env AI_MEMORY_DB=<AI_MEMORY_DB> -- docker run -i --rm -e AI_MEMORY_DB ghcr.io/alphaonedev/ai-memory:0.5.1Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"ai-memory": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AI_MEMORY_DB",
"ghcr.io/alphaonedev/ai-memory:0.5.1"
],
"env": {
"AI_MEMORY_DB": "<AI_MEMORY_DB>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"ai-memory": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AI_MEMORY_DB",
"ghcr.io/alphaonedev/ai-memory:0.5.1"
],
"env": {
"AI_MEMORY_DB": "<AI_MEMORY_DB>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e AI_MEMORY_DB=<AI_MEMORY_DB> ai-memory docker run -i --rm -e AI_MEMORY_DB ghcr.io/alphaonedev/ai-memory:0.5.1Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о ai-memory
Как установить ai-memory в Claude Code?
Выполните команду claude mcp add --env AI_MEMORY_DB=<AI_MEMORY_DB> --transport stdio ai-memory -- docker run -i --rm -e AI_MEMORY_DB ghcr.io/alphaonedev/ai-memory:0.5.1, указав свой путь к базе данных вместо <AI_MEMORY_DB>.
Что делает ai-memory?
Сервер сохраняет знания и предпочтения в локальной базе SQLite и выдаёт их ассистенту по мере необходимости. Контекст не расходует токены до момента извлечения.
Какая база данных используется для хранения?
По умолчанию используется локальный SQLite с FTS5. Для распределённых сценариев предусмотрена работа с PostgreSQL и расширением Apache AGE.
