Session Collab MCP

Provider-unabhängiger MCP-Server für Multi-Agent-/Multi-Session-Arbeit: Dateien beanspruchen, kurzes Arbeitsgedächtnis, Pfade schützen und Konflikte erkennen.

Funktioniert über stdio oder HTTP-JSON-RPC mit Claude Code, Codex, Grok, Cursor und anderen MCP-Clients. Optionale Claude-Code-Paketierung: plugin/.

Warum

Nur gleiche Maschine – das ist keine Remote-Git-Sperre. Parallele Coding-Sessions auf einem OS-Benutzer überschreiben sich gegenseitig, weil es keine gemeinsame „Arbeitsabsicht“ gibt. Dieser Server ist ein lokales WIP-Registry: Dateien deklarieren, Konflikte prüfen, kurze Notizen dauerhaft speichern, kritische Pfade schützen und wieder freigeben.

Related MCP server: agent-coord

Installation

stdio (beliebiger MCP-Client)

{
  "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 über HTTP: POST /mcp. Komfort-REST: /v1/* (1:1 mit MCP-Tools). Localhost benötigt kein Token; nicht-lokale Bindungen erfordern SESSION_COLLAB_HTTP_TOKEN und SESSION_COLLAB_ALLOWED_HOSTS (oder --allowed-host). Host/Origin werden validiert; /health verwendet bei gesetztem Token dieselben Prüfungen (dann ist Bearer erforderlich).

Claude-Code-Plugin

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

Global: npm install -g session-collab-mcp

Lokales Repository: npm run install:local und dann die MCP-Konfiguration auf dist/cli.js verweisen.

Workflow

Nur für nicht-triviale / Multi-Session-Arbeiten verwenden.

1. collab_session_start – gleicher name+Projekt wiederverwendet; restore_context Standard false

2. collab_claim action=create – Dateien stapelweise erfassen; atomisch beanspruchen-oder-blockieren; Pfade auf project_root normalisiert. check ist optional, nur zum Prüfen

3. collab_memory_save – nur kurze kurze Notizen (≤800 Zeichen, wird abgelehnt, wenn länger; kein Tresor)

4. collab_claim action=release, danach collab_session_end

list / status / Claim-Happy Path sind kompakt, außer bei detail=true.

Bei gemeinsamer Datei die Ansprüche auf Symbolebene bevorzugen. Überlappung führt zu waiting_for_coordination oder partial_claim_created.

Tools

v2.0-Breaking-Changes: MIGRATION.md. Vollständige Historie: CHANGELOG.md. Sicherheitsmeldungen: SECURITY.md.

Daten

SQLite ist pro Maschine / OS-Benutzer (WAL, offline). Pfadreihenfolge:

1. SESSION_COLLAB_DB, falls gesetzt

2. ~/.session-collab/collab.db, falls es bereits existiert

3. Legacy ~/.claude/session-collab/collab.db, falls es bereits existiert

4. Andernfalls ~/.session-collab/collab.db erstellen

collab_session_start gibt scope: "local-machine" und db_path zurück. Das Claude-Code-Plugin PreToolUse verweigert Write/Edit an Dateien, die von einer anderen Session beansprucht wurden (SESSION_COLLAB_HOOK_DISABLE=1 zum Überspringen).

Entwicklung

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

Optionale Legacy-Bundle: SESSION_COLLAB_INCLUDE_LEGACY=true npm run build (nicht in der v2-Tool-Liste).

Verwandt

• lazy-desktop-mcp

• lazy_mobile_mcp

• lazy-media-mcp

Lizenz

MIT © leaf76