memory-mcp — MCP-сервер для Claude Code: что делает и как установить
Сервер сохраняет контекст сессий и архитектурные решения в локальные файлы, создавая резервные снимки проекта в git.
claude mcp add memory-mcp -- npx -y claude-code-memoryЧто делает memory-mcp
Утилита перехватывает события сессии через хуки Claude Code, отправляет транскрипт модели Haiku и выделяет принятые решения, архитектурные паттерны и текущий прогресс. Данные сохраняются локально в .memory/state.json. Короткая выжимка до 150 строк попадает в CLAUDE.md, откуда агент считывает её при каждом новом старте.
Во время диалога доступны инструменты memory_search, memory_ask и memory_related для выборки точных деталей из накопившейся истории. При каждом обновлении памяти сервер фиксирует состояние рабочей директории коммитом в скрытой ветке git. Это позволяет откатиться назад, если агент сломал код.
Для работы фонового экстрактора требуется Node.js 18+ и рабочий ключ Anthropic API. Без оплаченного API-ключа автоматический сбор фактов через Haiku просто остановится.
Какие задачи решает
- сохранять контекст архитектуры между сессиями
- находить прошлые решения через поисковые инструменты
- откатывать проект к рабочему снимку в git
- очищать устаревшие воспоминания по таймеру
Примеры запросов агенту
- Найди через память, почему мы выбрали PostgreSQL вместо Redis для сессий.
- Посмотри в истории проекта, на каком шаге мы остановились вчера.
- Сделай поиск по сохранённым архитектурным паттернам аутентификации.
Как установить memory-mcp
Командой платформы
claude mcp add memory-mcp -- npx -y claude-code-memoryКомандой платформы
codex mcp add memory-mcp -- npx -y claude-code-memoryФайл настроек
{
"mcpServers": {
"memory-mcp": {
"command": "npx",
"args": [
"-y",
"claude-code-memory"
]
}
}
}Файл настроек
{
"servers": {
"memory-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"claude-code-memory"
]
}
}
}Командой платформы
gemini mcp add memory-mcp npx -y claude-code-memoryПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о memory-mcp
Как установить memory-mcp в Claude Code?
Выполните команду claude mcp add memory-mcp -- npx -y claude-code-memory. Затем для конфигурации хуков запустите memory-mcp setup в терминале.
Что делает memory-mcp?
Сервер автоматически выгружает факты и решения из диалогов с моделью, обновляя CLAUDE.md и базу .memory/state.json. Дополнительно он делает снимки проекта в git.
Нужен ли отдельный API-ключ для работы памяти?
Да, для извлечения фактов моделью Haiku требуется ключ Anthropic API. Его задают командой memory-mcp setup или memory-mcp key.
