# Counterparts

MCP-сервер Counterparts для Claude Code, создающий долговременную локальную память для ИИ-агента. Запускается при каждой новой сессии работы с проектом.

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

## Что делает

Counterparts записывает итоги сессий, решения и контекст работы прямо на локальной машине в базу данных SQLite. Память автоматически очищается от устаревших данных, а ключи и токены удаляются из записей до их сохранения. Для работы требуется Node 22.15 или новее, либо bun 1.3 или новее.

Инструмент сохраняет историю взаимодействия в папке пользователя и позволяет просматривать её через веб-интерфейс или командную строку. Обновления проверяются через запросы к репозиторию npm, но сами данные не покидают компьютер пользователя.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `COUNTERPARTS_DATA_DIR`, `COUNTERPARTS_CONFIG`, `COUNTERPARTS_UPDATE_CHECK` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env COUNTERPARTS_DATA_DIR=<COUNTERPARTS_DATA_DIR> --env COUNTERPARTS_CONFIG=<COUNTERPARTS_CONFIG> --env COUNTERPARTS_UPDATE_CHECK=<COUNTERPARTS_UPDATE_CHECK> --transport stdio counterparts -- npx -y counterparts
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add counterparts --env COUNTERPARTS_DATA_DIR=<COUNTERPARTS_DATA_DIR> --env COUNTERPARTS_CONFIG=<COUNTERPARTS_CONFIG> --env COUNTERPARTS_UPDATE_CHECK=<COUNTERPARTS_UPDATE_CHECK> -- npx -y counterparts
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "counterparts": {
            "command": "npx",
            "args": [
                "-y",
                "counterparts"
            ],
            "env": {
                "COUNTERPARTS_DATA_DIR": "<COUNTERPARTS_DATA_DIR>",
                "COUNTERPARTS_CONFIG": "<COUNTERPARTS_CONFIG>",
                "COUNTERPARTS_UPDATE_CHECK": "<COUNTERPARTS_UPDATE_CHECK>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "counterparts": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "counterparts"
            ],
            "env": {
                "COUNTERPARTS_DATA_DIR": "<COUNTERPARTS_DATA_DIR>",
                "COUNTERPARTS_CONFIG": "<COUNTERPARTS_CONFIG>",
                "COUNTERPARTS_UPDATE_CHECK": "<COUNTERPARTS_UPDATE_CHECK>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e COUNTERPARTS_DATA_DIR=<COUNTERPARTS_DATA_DIR> -e COUNTERPARTS_CONFIG=<COUNTERPARTS_CONFIG> -e COUNTERPARTS_UPDATE_CHECK=<COUNTERPARTS_UPDATE_CHECK> counterparts npx -y counterparts
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- открой панель управления памятью в браузере с помощью counterparts dashboard
- задай вопрос по накопленной памяти через counterparts ask "..."
- отключи ведение записей для текущей директории командой `counterparts scope . --off`

## Похожие
- [mem](https://affpapa.org/nevibecode/skills/mem.md) — скилл · 2400 установок
- [context-sync](https://affpapa.org/nevibecode/mcp/context-sync.md) — MCP-сервер · ★ 190 у репозитория
- [Renor](https://affpapa.org/nevibecode/mcp/renor.md) — MCP-сервер · ★ 55 у репозитория
- [Palinode](https://affpapa.org/nevibecode/mcp/palinode.md) — MCP-сервер · ★ 46 у репозитория
- [State Memory MCP](https://affpapa.org/nevibecode/mcp/state-memory-mcp.md) — MCP-сервер · ★ 44 у репозитория
- [callimachus](https://affpapa.org/nevibecode/mcp/callimachus.md) — MCP-сервер · ★ 50 у репозитория

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