anneal-memory — MCP-сервер для Claude Code: установка и суть
Двухуровневая локальная память для агентов без внешних зависимостей и векторных баз. Она проверяет факты перед сохранением и требует подтверждения выводов реальными эпизодами.
claude mcp add anneal-memory -- uvx anneal-memoryЧто делает anneal-memory
Сервер реализует модель дополняющего обучения (Complementary Learning Systems). Сначала агент ведёт быстрый журнал недавних действий и наблюдений. Позже отдельный шаг консолидации переносит проверенные выводы в файл стабильной идентичности и долгосрочные паттерны. Векторные базы не нужны. Вся логика опирается исключительно на стандартную библиотеку Python.
Встроенная защитная система проверяет каждое обобщение перед фиксацией. Паттерн повышает ранг только тогда, когда прямо ссылается на существующие эпизоды и совпадает с ними по смысловым словам. Выдуманные идентификаторы или частые повторы старых записей снижают позицию вывода. Механизм также ведёт учёт запланированных задач и хешированную цепочку аудита.
На платформе Windows консультативные блокировки fcntl не работают, поэтому параллельная запись из нескольких процессов приведёт к потере данных. В такой среде хранилище безопасно использовать строго в один поток, опираясь на атомарную замену временных файлов.
Какие задачи решает
- Защитить долговременную память агента от накопления непроверенных выдумок
- Сохранять контекст и решения между рабочими сессиями без внешних сервисов
- Снижать ранг обобщений, которые ссылаются на несуществующие события
- Удерживать список будущих задач через локальный файл
Примеры запросов агенту
- Вспомни, почему мы выбрали PostgreSQL для работы с базой данных
- Зафиксируй решение об ограничении пула соединений в памяти anneal-memory
- Сконсолидируй недавние эпизоды сессии и обнови файл идентичности
Как установить anneal-memory
Командой платформы
claude mcp add anneal-memory -- uvx anneal-memoryuvx запускает команду с именем пакета; если в README она другая — uvx --from anneal-memory <команда>
Командой платформы
codex mcp add anneal-memory -- uvx anneal-memoryuvx запускает команду с именем пакета; если в README она другая — uvx --from anneal-memory <команда>
Файл настроек
{
"mcpServers": {
"anneal-memory": {
"command": "uvx",
"args": [
"anneal-memory"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from anneal-memory <команда>
Файл настроек
{
"servers": {
"anneal-memory": {
"type": "stdio",
"command": "uvx",
"args": [
"anneal-memory"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from anneal-memory <команда>
Командой платформы
gemini mcp add anneal-memory uvx anneal-memoryuvx запускает команду с именем пакета; если в README она другая — uvx --from anneal-memory <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о anneal-memory
Как установить anneal-memory в Claude Code?
Выполните команду claude mcp add anneal-memory -- uvx anneal-memory. Для работы потребуется наличие пакетного менеджера uv.
Зачем нужна проверка цитирования в anneal-memory?
Она защищает агента от закрепления ложных фактов. Паттерн повышает свой уровень только в том случае, если подтверждается реальными совпадениями слов из записанных эпизодов.
Есть ли ограничения при работе на Windows?
На Windows отсутствуют межпроцессные блокировки fcntl. Чтобы избежать повреждения записей, запускать операции с хранилищем нужно строго в один поток.