shodh-memory — MCP-сервер для Claude Code: что делает и как установить
Добавляет агенту трёхуровневую когнитивную память, семантический поиск заметок и трекер задач по методологии GTD.
claude mcp add --env SHODH_API_URL=<SHODH_API_URL> --env SHODH_API_KEY=<SHODH_API_KEY> --env SHODH_USER_ID=<SHODH_USER_ID> --transport stdio mcp-server -- npx -y @shodh/memory-mcpЧто делает shodh-memory
Сервер распределяет воспоминания по рабочей, сессионной и долгосрочной памяти на основе когнитивной модели Коуэна. Для семантического поиска смыслов используется модель встраивания MiniLM-L6, а связи между сущностями выстраиваются в граф знаний. При повторных обращениях ассоциации закрепляются по правилу Хебба. Повторные записи отсекаются по хешу содержимого.
По умолчанию связь с бэкендом идёт по HTTP, но поддерживается и локальный транспорт IPC через Unix-сокеты или именованные каналы Windows. При первом старте загружаются бинарный исполняемый файл на 15 МБ и файлы весов модели на 23 МБ. Без действующего ключа в SHODH_API_KEY сервер не запустится.
Какие задачи решает
- сохранять контекст и принятые решения между отдельными сессиями агента
- находить релевантные заметки по смыслу через модель векторов MiniLM-L6
- вести списки задач, проектов и напоминаний по системе GTD прямо в чате
- предотвращать дублирование данных за счёт сверки хешей содержимого
Примеры запросов агенту
- Вспомни архитектурные решения по нашему бэкенду из прошлой сессии.
- Сохрани это правило обработки ошибок в долговременную память с тегом backend.
- Покажи список открытых задач по текущему проекту рефакторинга.
Как установить shodh-memory
Командой платформы
claude mcp add --env SHODH_API_URL=<SHODH_API_URL> --env SHODH_API_KEY=<SHODH_API_KEY> --env SHODH_USER_ID=<SHODH_USER_ID> --transport stdio mcp-server -- npx -y @shodh/memory-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp-server --env SHODH_API_URL=<SHODH_API_URL> --env SHODH_API_KEY=<SHODH_API_KEY> --env SHODH_USER_ID=<SHODH_USER_ID> -- npx -y @shodh/memory-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@shodh/memory-mcp"
],
"env": {
"SHODH_API_URL": "<SHODH_API_URL>",
"SHODH_API_KEY": "<SHODH_API_KEY>",
"SHODH_USER_ID": "<SHODH_USER_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@shodh/memory-mcp"
],
"env": {
"SHODH_API_URL": "<SHODH_API_URL>",
"SHODH_API_KEY": "<SHODH_API_KEY>",
"SHODH_USER_ID": "<SHODH_USER_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e SHODH_API_URL=<SHODH_API_URL> -e SHODH_API_KEY=<SHODH_API_KEY> -e SHODH_USER_ID=<SHODH_USER_ID> mcp-server npx -y @shodh/memory-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о shodh-memory
Как установить shodh-memory в Claude Code?
Выполните команду claude mcp add shodh-memory -e SHODH_API_KEY=<SHODH_API_KEY> -- npx -y @shodh/memory-mcp, указав собственный ключ авторизации вместо плейсхолдера.
Нужен ли доступ в интернет для работы shodh-memory?
Сеть требуется только при первом запуске для загрузки бинарного файла и модели общим весом около 38 МБ. После этого поиск и обработка графа выполняются локально.
Какие инструменты сервер предоставляет ассистенту?
В распоряжении агента 51 инструмент, в том числе remember для сохранения фактов, recall для поиска по смыслу и proactive_context для автоматического извлечения контекста сессии.
