alaya-mcp — MCP-сервер для Claude Code: что делает и как установить
Локальный движок памяти для ИИ-агентов с графом знаний и затуханием воспоминаний. Хранит историю диалогов в SQLite без раздувания контекста.
claude mcp add --env ALAYA_LLM_API_KEY=<ALAYA_LLM_API_KEY> --env ALAYA_LLM_API_URL=<ALAYA_LLM_API_URL> --env ALAYA_LLM_MODEL=<ALAYA_LLM_MODEL> --env ALAYA_DB=<ALAYA_DB> --transport stdio alaya-mcp -- npx -y alaya-mcpЧто делает alaya-mcp
Сервер берёт на себя долговременную память агента на базе движка Rust. Он сохраняет диалоги по эпизодам и формирует граф знаний прямо в файле ~/.alaya/memory.db.
Механика опирается на принципы когнитивной биологии. Связи между сущностями крепнут при совместном вызове, а невостребованные записи постепенно угасают по модели Бьорка. Для управления доступны инструменты remember, recall, neighbors и lifecycle.
Сервер работает автономно через BM25, если внешние эмбеддинги не подключены. Переменные ALAYA_LLM_API_KEY и ALAYA_LLM_MODEL нужны только для автоматического извлечения фактов сторонней моделью.
Какие задачи решает
- сохранять контекст прошлых сессий без передачи всей истории диалога
- находить нужные факты семантическим поиском через recall
- очищать неактуальные данные алгоритмом затухания памяти
- исследовать связи между сущностями с помощью neighbors
Примеры запросов агенту
- Вспомни через alaya, какие настройки базы данных мы обсуждали вчера.
- Сохрани этот разговор в память alaya и свяжи концепции.
- Запусти lifecycle в alaya, чтобы обновить веса воспоминаний.
Как установить alaya-mcp
Командой платформы
claude mcp add --env ALAYA_LLM_API_KEY=<ALAYA_LLM_API_KEY> --env ALAYA_LLM_API_URL=<ALAYA_LLM_API_URL> --env ALAYA_LLM_MODEL=<ALAYA_LLM_MODEL> --env ALAYA_DB=<ALAYA_DB> --transport stdio alaya-mcp -- npx -y alaya-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add alaya-mcp --env ALAYA_LLM_API_KEY=<ALAYA_LLM_API_KEY> --env ALAYA_LLM_API_URL=<ALAYA_LLM_API_URL> --env ALAYA_LLM_MODEL=<ALAYA_LLM_MODEL> --env ALAYA_DB=<ALAYA_DB> -- npx -y alaya-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"alaya-mcp": {
"command": "npx",
"args": [
"-y",
"alaya-mcp"
],
"env": {
"ALAYA_LLM_API_KEY": "<ALAYA_LLM_API_KEY>",
"ALAYA_LLM_API_URL": "<ALAYA_LLM_API_URL>",
"ALAYA_LLM_MODEL": "<ALAYA_LLM_MODEL>",
"ALAYA_DB": "<ALAYA_DB>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"alaya-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"alaya-mcp"
],
"env": {
"ALAYA_LLM_API_KEY": "<ALAYA_LLM_API_KEY>",
"ALAYA_LLM_API_URL": "<ALAYA_LLM_API_URL>",
"ALAYA_LLM_MODEL": "<ALAYA_LLM_MODEL>",
"ALAYA_DB": "<ALAYA_DB>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e ALAYA_LLM_API_KEY=<ALAYA_LLM_API_KEY> -e ALAYA_LLM_API_URL=<ALAYA_LLM_API_URL> -e ALAYA_LLM_MODEL=<ALAYA_LLM_MODEL> -e ALAYA_DB=<ALAYA_DB> alaya-mcp npx -y alaya-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о alaya-mcp
Как установить alaya-mcp в Claude Code?
Выполните в терминале команду: claude mcp add alaya-mcp -e ALAYA_LLM_API_KEY=<ALAYA_LLM_API_KEY> -- npx -y alaya-mcp. Значение <ALAYA_LLM_API_KEY> замените на свой ключ.
Что делает alaya-mcp?
Сервер организует структурированную память агента в локальной базе SQLite. Диалоги разбиваются на эпизоды, превращаются в граф знаний и очищаются от устаревших сведений.
Обязательно ли задавать переменные ALAYA_LLM?
Переменные окружения опциональны. Без них сервер использует поиск BM25 и позволяет агенту извлекать факты из собственного контекста.
