Sugar — MCP-сервер для Claude Code: память проекта
Локальная память для ИИ-агента: решения, конвенции и грабли хранятся в SQLite и подтягиваются в новой сессии. Пригодится, когда агент каждый раз забывает, о чём вы договорились.
claude mcp add --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env GITHUB_TOKEN=<GITHUB_TOKEN> --env SUGAR_DEFAULT_REPO=<SUGAR_DEFAULT_REPO> --transport stdio sugar -- uvx sugaraiЧто делает Sugar
Sugar — это MCP-сервер, который даёт агенту читать и писать память прямо во время сессии. Проектные записи лежат в .sugar/memory.db, общие — в ~/.sugar/memory.db. Семь типов памяти: decision, preference, file_context, error_pattern, research, outcome, guideline. У части типов есть срок жизни: error_pattern живёт 90 дней, research — 60, outcome — 30, остальные не истекают.
Поиск семантический через sentence-transformers (модель all-MiniLM-L6-v2, векторы 384) и sqlite-vec. Если поставить пакет без extras, останется поиск по ключевым словам через SQLite FTS5. Внешних API-вызовов нет — всё считается на вашей машине. Порядок выдачи такой: сначала проект, потом зарезервированные слоты под глобальные guideline, затем остальные глобальные записи, с дедупликацией между хранилищами.
Память можно наполнять и из командной строки: sugar remember "..." --type preference, sugar recall "authentication", sugar memories --global. Агент вызывает инструменты search_memory, store_learning, recall, get_project_context, list_recent_memories. Для семантического поиска нужен pipx install 'sugarai[memory]' — без него сервер запустится, но будет искать по словам.
Какие задачи решает
- вернуть агенту контекст проекта после перезапуска сессии
- записать архитектурное решение, чтобы оно не потерялось
- найти прошлые заметки по смыслу, а не по точному слову
- держать общие стандарты кода во всех проектах сразу
- хранить разбор ошибки вместе с её исправлением
Примеры запросов агенту
- Найди в памяти всё про аутентификацию и покажи, что мы решили по JWT
- Запомни: тесты падают с ошибкой импорта — сначала проверяем экспорты в
__init__.py - Сохрани в глобальную память правило: всегда валидировать пользовательский ввод перед запросом в базу
Как установить Sugar
Командой платформы
claude mcp add --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env GITHUB_TOKEN=<GITHUB_TOKEN> --env SUGAR_DEFAULT_REPO=<SUGAR_DEFAULT_REPO> --transport stdio sugar -- uvx sugaraiВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sugarai <команда>
Командой платформы
codex mcp add sugar --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env GITHUB_TOKEN=<GITHUB_TOKEN> --env SUGAR_DEFAULT_REPO=<SUGAR_DEFAULT_REPO> -- uvx sugaraiВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sugarai <команда>
Файл настроек
{
"mcpServers": {
"sugar": {
"command": "uvx",
"args": [
"sugarai"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"SUGAR_DEFAULT_REPO": "<SUGAR_DEFAULT_REPO>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sugarai <команда>
Файл настроек
{
"servers": {
"sugar": {
"type": "stdio",
"command": "uvx",
"args": [
"sugarai"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"GITHUB_TOKEN": "<GITHUB_TOKEN>",
"SUGAR_DEFAULT_REPO": "<SUGAR_DEFAULT_REPO>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sugarai <команда>
Командой платформы
gemini mcp add -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e GITHUB_TOKEN=<GITHUB_TOKEN> -e SUGAR_DEFAULT_REPO=<SUGAR_DEFAULT_REPO> sugar uvx sugaraiВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from sugarai <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Sugar
Как установить Sugar в Claude Code?
Сначала поставьте пакет: pipx install sugarai, для семантического поиска — pipx install 'sugarai[memory]'. Затем подключите сервер памяти командой claude mcp add sugar -- sugar mcp memory.
Что делает Sugar?
Хранит контекст проекта и общие правила в двух базах SQLite и отдаёт их агенту через MCP. Агент сам ищет нужное перед работой и сохраняет выводы после.
Нужны ли API-ключи для работы Sugar?
Нет. Поиск и хранение идут локально, внешних вызовов нет. В командах подключения для Codex, Cursor, GitHub Copilot и Gemini CLI встречаются переменные ANTHROPIC_API_KEY, GITHUB_TOKEN и SUGAR_DEFAULT_REPO — они относятся к опциональному серверу задач.
