# agent-memory-os

Локальный MCP-сервер agent-memory-os для Claude Code хранит память агентов, проектов и команд с ACL и синхронизацией между узлами. Обеспечивает общую память нескольких агентов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 9 у репозитория
- Автор: yamantaka520
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/yamantaka520/Agent-Memory-OS
- Обновлён: 2026-10-01
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/agent-memory-os

## Что делает

\`agent-memory-os` хранит данные в одном файле SQLite с индексом FTS5 и даёт агентам память разных областей: личную, командную, проектную и глобальную. Доступ проверяется до ранжирования, поэтому агент видит только разрешённые записи. Связи между воспоминаниями поддерживают ассоциативный поиск, а контекст для каждого запроса собирается в пределах заданного бюджета токенов.

Сервер умеет синхронизировать память и структуру команд между узлами через переносимые пакеты и связь с узлами-партнёрами. Встроены обнаружение противоречий, объединение дублей, затухание, закрепление и отзыв доступа. Веб-интерфейс, MCP-сервер и семантические векторы подключаются как дополнительные компоненты. Для раздельной идентификации агентов задайте `AGENT_MEMORY_AGENT_ID` и при необходимости `AGENT_MEMORY_HOME`.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `AGENT_MEMORY_AGENT_ID`, `AGENT_MEMORY_HOME` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env AGENT_MEMORY_AGENT_ID=<AGENT_MEMORY_AGENT_ID> --env AGENT_MEMORY_HOME=<AGENT_MEMORY_HOME> --transport stdio agent-memory-os -- uvx agent-memory-os
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-memory-os <команда>

### Codex

**Командой платформы**
```bash
codex mcp add agent-memory-os --env AGENT_MEMORY_AGENT_ID=<AGENT_MEMORY_AGENT_ID> --env AGENT_MEMORY_HOME=<AGENT_MEMORY_HOME> -- uvx agent-memory-os
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-memory-os <команда>

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e AGENT_MEMORY_AGENT_ID=<AGENT_MEMORY_AGENT_ID> -e AGENT_MEMORY_HOME=<AGENT_MEMORY_HOME> agent-memory-os uvx agent-memory-os
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from agent-memory-os <команда>

## Когда брать
- хранить память нескольких AI-агентов
- разделить записи по командам и проектам
- ограничить выдачу через ACL
- синхронизировать память между узлами
- находить связанные воспоминания без общих слов

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

## Похожие
- [Vector Search — In-Memory TF-IDF Semantic Store](https://affpapa.org/nevibecode/mcp/vector-search-in-memory-tf-idf-semantic-store.md) — MCP-сервер · 3562 установки
- [OMEGA Memory](https://affpapa.org/nevibecode/mcp/omega-memory-omega-memory.md) — MCP-сервер · 2862 установки
- [deep-agents-memory](https://affpapa.org/nevibecode/skills/deep-agents-memory.md) — скилл · 20000 установок
- [memory-safety-patterns](https://affpapa.org/nevibecode/skills/memory-safety-patterns.md) — скилл · 11746 установок
- [memory-management](https://affpapa.org/nevibecode/skills/memory-management.md) — скилл · 7800 установок
- [memory-discipline](https://affpapa.org/nevibecode/skills/memory-discipline.md) — скилл · 4900 установок

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