# Echo Memory

Echo Memory — MCP-сервер для Claude Code и других агентов, который хранит общую память как граф фактов в Postgres. Запись одного агента становится доступной другим без вызова модели.

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

## Что делает

Сервер хранит факты как рёбра графа между сущностями: два агента, которые никогда не работали вместе, разрешают имена в одну сущность и видят то, что узнал другой. Каждый факт несёт метку, кто его записал и когда; запись не вызывает модель. Поиск по гибридному индексу (векторный + BM25) возвращает ранжированный список с оценкой релевантности и объяснением, по каким каналам факт попал в ответ.

Запускается либо через Docker с собственной базой Postgres, либо через хостинг `https://api.echo-mem.com/mcp` без установки базы. Требует Python 3.11+ и настройки переменных окружения `ECHO_MEMORY_DATABASE_URL`, `ECHO_MEMORY_USER_ID`, `ECHO_MEMORY_AGENT_ID`.

Семь инструментов: `write_episode` сохраняет факты без вызова модели, `query_memory` ищет по запросу и времени `as_of`, `trace_cause` строит цепочки причинно-следственных связей, `get_audit_log` показывает историю изменений. Команда `echo-memory health` выводит оценку качества хранилища и советы по улучшению.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://api.echo-mem.com/mcp`
- Переменные окружения: `ECHO_MEMORY_DATABASE_URL`, `ECHO_MEMORY_USER_ID`, `ECHO_MEMORY_AGENT_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы**
```bash
claude mcp add echo-mem -e ECHO_MEMORY_DATABASE_URL=<ECHO_MEMORY_DATABASE_URL> -e ECHO_MEMORY_USER_ID=<ECHO_MEMORY_USER_ID> -e ECHO_MEMORY_AGENT_ID=<ECHO_MEMORY_AGENT_ID> -- uvx echo-mem
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from echo-mem <команда>

2. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http echo-memory https://api.echo-mem.com/mcp
```

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add echo-memory --url https://api.echo-mem.com/mcp
```

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

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "echo-memory": {
            "url": "https://api.echo-mem.com/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "echo-memory": {
            "command": "uvx",
            "args": [
                "echo-mem"
            ],
            "env": {
                "ECHO_MEMORY_DATABASE_URL": "<ECHO_MEMORY_DATABASE_URL>",
                "ECHO_MEMORY_USER_ID": "<ECHO_MEMORY_USER_ID>",
                "ECHO_MEMORY_AGENT_ID": "<ECHO_MEMORY_AGENT_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from echo-mem <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "echo-memory": {
            "type": "http",
            "url": "https://api.echo-mem.com/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "echo-memory": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "echo-mem"
            ],
            "env": {
                "ECHO_MEMORY_DATABASE_URL": "<ECHO_MEMORY_DATABASE_URL>",
                "ECHO_MEMORY_USER_ID": "<ECHO_MEMORY_USER_ID>",
                "ECHO_MEMORY_AGENT_ID": "<ECHO_MEMORY_AGENT_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from echo-mem <команда>

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http echo-memory https://api.echo-mem.com/mcp
```

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

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

## Примеры запросов агенту
- Сохрани, что биллинг использует Razorpay, а не Stripe
- Покажи все факты про платёжный модуль на прошлой неделе
- Построй цепочку причин, почему упала производительность

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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