# anneal-memory

Двухуровневая локальная память для агентов без внешних зависимостей и векторных баз. Она проверяет факты перед сохранением и требует подтверждения выводов реальными эпизодами.

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

## Что делает

Сервер реализует модель дополняющего обучения (Complementary Learning Systems). Сначала агент ведёт быстрый журнал недавних действий и наблюдений. Позже отдельный шаг консолидации переносит проверенные выводы в файл стабильной идентичности и долгосрочные паттерны. Векторные базы не нужны. Вся логика опирается исключительно на стандартную библиотеку Python.

Встроенная защитная система проверяет каждое обобщение перед фиксацией. Паттерн повышает ранг только тогда, когда прямо ссылается на существующие эпизоды и совпадает с ними по смысловым словам. Выдуманные идентификаторы или частые повторы старых записей снижают позицию вывода. Механизм также ведёт учёт запланированных задач и хешированную цепочку аудита.

На платформе Windows консультативные блокировки `fcntl` не работают, поэтому параллельная запись из нескольких процессов приведёт к потере данных. В такой среде хранилище безопасно использовать строго в один поток, опираясь на атомарную замену временных файлов.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

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

**Командой платформы**
```bash
claude mcp add anneal-memory -- uvx anneal-memory
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from anneal-memory <команда>

### Codex

**Командой платформы**
```bash
codex mcp add anneal-memory -- uvx anneal-memory
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from anneal-memory <команда>

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add anneal-memory uvx anneal-memory
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from anneal-memory <команда>

## Когда брать
- Защитить долговременную память агента от накопления непроверенных выдумок
- Сохранять контекст и решения между рабочими сессиями без внешних сервисов
- Снижать ранг обобщений, которые ссылаются на несуществующие события
- Удерживать список будущих задач через локальный файл

## Примеры запросов агенту
- Вспомни, почему мы выбрали PostgreSQL для работы с базой данных
- Зафиксируй решение об ограничении пула соединений в памяти anneal-memory
- Сконсолидируй недавние эпизоды сессии и обнови файл идентичности

## Похожие
- [deep-agents-memory](https://affpapa.org/nevibecode/skills/deep-agents-memory.md) — скилл · 19000 установок
- [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 установок
- [memory-search](https://affpapa.org/nevibecode/skills/ruvnet-memory-search.md) — скилл · 750 установок
- [memory-systems](https://affpapa.org/nevibecode/skills/memory-systems.md) — скилл · 393 установки

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