# hot-memory-mcp

Сохраняет знания о проекте и подставляет часто используемые факты в контекст. Нужен, когда агенту приходится заново объяснять архитектуру и правила.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Автор: michael-denyer
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/michael-denyer/memory-mcp
- Обновлён: 2026-10-14
- HTML: https://affpapa.org/nevibecode/mcp/hot-memory-mcp

## Что делает

\`hot-memory-mcp` хранит воспоминания в двух слоях. Горячий кэш попадает в контекст через хуки `SessionStart` и `UserPromptSubmit`, а остальные записи находятся семантическим поиском. Часто используемые факты система продвигает сама, устаревшие постепенно опускает.

MCP-сервер разделяет память по git-репозиториям и связывает связанные понятия графом знаний. Для заполнения базы после установки нужно один раз выполнить `memory-mcp-cli bootstrap`; сам сервер не берёт знания из документов автоматически. Embeddings работают через `sentence-transformers`, а модель скачивается при первом запуске.

Без Python 3.10+ и загрузки embedding-модели сервер не подготовится к работе. Для управления памятью доступны команды `/memory-mcp:remember`, `/memory-mcp:recall`, `/memory-mcp:hot-cache`, `/memory-mcp:stats` и `/memory-mcp:bootstrap`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `MEMORY_MCP_DB_PATH`, `MEMORY_MCP_EMBEDDING_MODEL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env MEMORY_MCP_DB_PATH=<MEMORY_MCP_DB_PATH> --env MEMORY_MCP_EMBEDDING_MODEL=<MEMORY_MCP_EMBEDDING_MODEL> --transport stdio hot-memory-mcp -- uvx hot-memory-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hot-memory-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add hot-memory-mcp --env MEMORY_MCP_DB_PATH=<MEMORY_MCP_DB_PATH> --env MEMORY_MCP_EMBEDDING_MODEL=<MEMORY_MCP_EMBEDDING_MODEL> -- uvx hot-memory-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hot-memory-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hot-memory-mcp": {
            "command": "uvx",
            "args": [
                "hot-memory-mcp"
            ],
            "env": {
                "MEMORY_MCP_DB_PATH": "<MEMORY_MCP_DB_PATH>",
                "MEMORY_MCP_EMBEDDING_MODEL": "<MEMORY_MCP_EMBEDDING_MODEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hot-memory-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "hot-memory-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "hot-memory-mcp"
            ],
            "env": {
                "MEMORY_MCP_DB_PATH": "<MEMORY_MCP_DB_PATH>",
                "MEMORY_MCP_EMBEDDING_MODEL": "<MEMORY_MCP_EMBEDDING_MODEL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hot-memory-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MEMORY_MCP_DB_PATH=<MEMORY_MCP_DB_PATH> -e MEMORY_MCP_EMBEDDING_MODEL=<MEMORY_MCP_EMBEDDING_MODEL> hot-memory-mcp uvx hot-memory-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from hot-memory-mcp <команда>

## Когда брать
- сохранять архитектурные решения между сессиями
- находить факты о проекте по смыслу
- подставлять частые знания в контекст без отдельного поиска
- отделять память разных git-репозиториев
- проверять содержимое базы через дашборд

## Примеры запросов агенту
- Сохрани решение о структуре API и свяжи его с текущим проектом.
- Найди в памяти правила работы с авторизацией и объясни, какие из них относятся к этому репозиторию.
- Запусти `/memory-mcp:bootstrap` и добавь сведения из документации проекта.

## Похожие
- [shodh-memory](https://affpapa.org/nevibecode/mcp/shodh-memory.md) — MCP-сервер · ★ 316
- [openviking-memory](https://affpapa.org/nevibecode/skills/openviking-memory.md) — скилл · 504 установки
- [agent-memory-systems](https://affpapa.org/nevibecode/skills/sickn33-agent-memory-systems.md) — скилл · 2000 установок
- [memory-lancedb-pro-openclaw](https://affpapa.org/nevibecode/skills/memory-lancedb-pro-openclaw.md) — скилл · 1300 установок
- [AgentDB Memory Patterns](https://affpapa.org/nevibecode/skills/agentdb-memory-patterns.md) — скилл · 1100 установок
- [Mneme Memory](https://affpapa.org/nevibecode/mcp/mneme-memory.md) — MCP-сервер · ★ 182

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md