Toon Memory — MCP-сервер для Claude Code: что делает и как установить
Локальная память для кодинг-агентов без облака. Хранит архитектурные решения и договорённости проекта между сессиями в формате TOON.
claude mcp add --env TOON_MEMORY_KEY=<TOON_MEMORY_KEY> --env TOON_MEMORY_CAPTURE=<TOON_MEMORY_CAPTURE> --env TOON_MEMORY_SESSION_ID=<TOON_MEMORY_SESSION_ID> --env TOON_MEMORY_BRANCH=<TOON_MEMORY_BRANCH> --env TOON_MEMORY_NO_SESSION=<TOON_MEMORY_NO_SESSION> --transport stdio toon-memory -- npx -y toon-memoryЧто делает Toon Memory
Сервер сохраняет принятые решения по кодовой базе, соглашения о библиотеках и контекст исправленных ошибок прямо на диске разработчика. Для этого не нужны облачные сервисы: данные лежат локально в каталоге .toon-memory/memory/, который утилита автоматически добавляет в .gitignore. Формат разметки TOON расходует на 22% меньше токенов по сравнению с привычным JSON.
Внутри находится набор из 35 MCP-инструментов. Метод memory_smart_recall извлекает релевантный контекст перед началом задачи, memory_checkpoint делает снимки сессий с временем жизни 7 дней, а memory_secret защищает конфиденциальные данные с помощью шифрования AES-256-GCM. Записи объединяются ссылками в граф памяти: алгоритм BM25 комбинируется с анализом связности узлов без вызова сторонних эмбеддингов.
При начальной инициализации toon-memory init сканирует манифесты вроде package.json или requirements.txt для автоматического присвоения тегов по зависимостям. Если вы хотите шифровать хранилище или синхронизировать записи через GitHub Gist, в окружении обязательно понадобятся переменные TOON_MEMORY_KEY и GITHUB_TOKEN.
Какие задачи решает
- сохранять архитектурные решения между рабочими сессиями агента
- избегать повторных объяснений правил проекта и выбранного стека
- находить связанные контекстные записи через поиск BM25 и граф
- удалять дубликаты и очищать устаревшие знания проекта
Примеры запросов агенту
- Найди в памяти проекта, почему мы выбрали именно эту библиотеку для валидации
- Сохрани в память исправление пула соединений базы данных с тегом backend
- Сделай чекпоинт текущей сессии с фиксацией изменений архитектуры
Как установить Toon Memory
Командой платформы
claude mcp add --env TOON_MEMORY_KEY=<TOON_MEMORY_KEY> --env TOON_MEMORY_CAPTURE=<TOON_MEMORY_CAPTURE> --env TOON_MEMORY_SESSION_ID=<TOON_MEMORY_SESSION_ID> --env TOON_MEMORY_BRANCH=<TOON_MEMORY_BRANCH> --env TOON_MEMORY_NO_SESSION=<TOON_MEMORY_NO_SESSION> --transport stdio toon-memory -- npx -y toon-memoryВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
codex mcp add toon-memory --env TOON_MEMORY_KEY=<TOON_MEMORY_KEY> --env TOON_MEMORY_CAPTURE=<TOON_MEMORY_CAPTURE> --env TOON_MEMORY_SESSION_ID=<TOON_MEMORY_SESSION_ID> --env TOON_MEMORY_BRANCH=<TOON_MEMORY_BRANCH> --env TOON_MEMORY_NO_SESSION=<TOON_MEMORY_NO_SESSION> -- npx -y toon-memoryВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"mcpServers": {
"toon-memory": {
"command": "npx",
"args": [
"-y",
"toon-memory"
],
"env": {
"TOON_MEMORY_KEY": "<TOON_MEMORY_KEY>",
"TOON_MEMORY_CAPTURE": "<TOON_MEMORY_CAPTURE>",
"TOON_MEMORY_SESSION_ID": "<TOON_MEMORY_SESSION_ID>",
"TOON_MEMORY_BRANCH": "<TOON_MEMORY_BRANCH>",
"TOON_MEMORY_NO_SESSION": "<TOON_MEMORY_NO_SESSION>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Файл настроек
{
"servers": {
"toon-memory": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"toon-memory"
],
"env": {
"TOON_MEMORY_KEY": "<TOON_MEMORY_KEY>",
"TOON_MEMORY_CAPTURE": "<TOON_MEMORY_CAPTURE>",
"TOON_MEMORY_SESSION_ID": "<TOON_MEMORY_SESSION_ID>",
"TOON_MEMORY_BRANCH": "<TOON_MEMORY_BRANCH>",
"TOON_MEMORY_NO_SESSION": "<TOON_MEMORY_NO_SESSION>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
Командой платформы
gemini mcp add -e TOON_MEMORY_KEY=<TOON_MEMORY_KEY> -e TOON_MEMORY_CAPTURE=<TOON_MEMORY_CAPTURE> -e TOON_MEMORY_SESSION_ID=<TOON_MEMORY_SESSION_ID> -e TOON_MEMORY_BRANCH=<TOON_MEMORY_BRANCH> -e TOON_MEMORY_NO_SESSION=<TOON_MEMORY_NO_SESSION> toon-memory npx -y toon-memoryВместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Toon Memory
Как установить Toon Memory в Claude Code?
Выполните в терминале команду: claude mcp add toon-memory -e TOON_MEMORY_KEY=<TOON_MEMORY_KEY> -e GITHUB_TOKEN=<GITHUB_TOKEN> -- npx -y toon-memory. Значения в угловых скобках замените на ваши ключи.
Что делает Toon Memory?
Сервер организует долговременное хранение контекста на локальном диске, передавая агенту историю решений, структуру проекта и проектные соглашения через Model Context Protocol.
Нужен ли внешний сервис для работы графа памяти?
Внешние сервисы не требуются. Поиск и ранжирование узлов графа выполняются локально через алгоритм BM25 и метрики связности без векторных баз и сторонних LLM.
