Session Collab MCP

Провайдер-агностический MCP сервер для многоджентной / многосессионной работы: резервирование файлов, краткосрочная рабочая память, защита путей и обнаружение конфликтов.

Работает через stdio или HTTP JSON-RPC с Claude Code, Codex, Grok, Cursor и другими MCP-клиентами. Опциональная упаковка для Claude Code: plugin/.

Зачем

Только на одной машине — это не удалённая блокировка Git. Параллельные сессии кодирования на одном пользователе ОС перезаписывают друг друга, потому что нет общего «намерения работы». Этот сервер — локальный реестр WIP: объявляйте файлы, проверяйте конфликты, сохраняйте короткие заметки, защищайте критичные пути, затем освобождайте.

Related MCP server: agent-coord

Установка

stdio (любой MCP-клиент)

{
  "mcpServers": {
    "session-collab": {
      "command": "npx",
      "args": ["-y", "session-collab-mcp@latest"]
    }
  }
}

HTTP + CLI

session-collab-http --host 127.0.0.1 --port 8765
session-collab doctor --base-url http://127.0.0.1:8765

MCP через HTTP: POST /mcp. Удобный REST: /v1/* (1:1 с MCP-инструментами). Для localhost не нужен токен; нелокальные привязки требуют SESSION_COLLAB_HTTP_TOKEN и SESSION_COLLAB_ALLOWED_HOSTS (или --allowed-host). Host/Origin проверяются; /health использует те же проверки (bearer обязателен, если задан токен).

Плагин Claude Code

/plugin marketplace add leaf76/session-collab-mcp
/plugin install session-collab@session-collab-plugins

Глобально: npm install -g session-collab-mcp

Локальный репозиторий: npm run install:local, затем укажите MCP-конфигурацию на dist/cli.js.

Рабочий процесс

Используйте только для нетривиальной / многосессионной работы.

1. collab_session_start — тот же name+проект повторно использует; restore_context по умолчанию false

2. collab_claim action=create — пакетные файлы; атомарное резервирование или блокировка; пути нормализуются к project_root. check — необязательный, только для проверки

3. collab_memory_save — только короткие заметки (≤800 символов, отклоняется, если длиннее; не хранилище)

4. collab_claim action=release, затем collab_session_end

list / status / claim happy-path компактны, если не задано detail=true.

Предпочитайте заявки на уровне символов при совместном использовании файла. Пересечение возвращает waiting_for_coordination или partial_claim_created.

Инструменты

Критические изменения v2.0: MIGRATION.md. Полная история: CHANGELOG.md. Отчёты о безопасности: SECURITY.md.

Данные

SQLite — на машину / на пользователя (WAL, офлайн). Порядок путей:

1. SESSION_COLLAB_DB, если задан

2. ~/.session-collab/collab.db, если он уже существует

3. унаследованный ~/.claude/session-collab/collab.db, если он уже существует

4. в противном случае создать ~/.session-collab/collab.db

collab_session_start возвращает scope: "local-machine" и db_path. Плагин Claude Code PreToolUse отклоняет Write/Edit на файлы, зарезервированные другой сессией (SESSION_COLLAB_HOOK_DISABLE=1 для пропуска).

Разработка

Node.js 18+. npm install && npm run build

npm run typecheck
npm run lint
npm run test
npm run test:http      # needs a local listen port
npm run test:release

Опциональный унаследованный пакет: SESSION_COLLAB_INCLUDE_LEGACY=true npm run build (не в списке инструментов v2).

Связанные

• lazy-desktop-mcp

• lazy_mobile_mcp

• lazy-media-mcp

Лицензия

MIT © leaf76