Session Collab MCP

 [

Hmm, I must not produce incorrect. Let me carefully paste the badge lines verbatim:

Those are exactly.

Now, write final.

Let me now type in the final# Session Collab MCP

Servidor MCP independiente del proveedor para el trabajo multiagente / multisesión: reclamar archivos, memoria de trabajo corta, proteger rutas y detectar conflictos.

Funciona sobre stdio o HTTP JSON-RPC con Claude Code, Codex, Grok, Cursor y otros clientes MCP. Empaquetado opcional para Claude Code: plugin/.

Por qué

Solo en la misma máquina: no es un bloqueo remoto de Git. Las sesiones de programación paralelas de un mismo usuario del SO se sobrescriben entre sí porque no hay una “intención de trabajo” compartida. Este servidor es un registro WIP local: declarar archivos, comprobar conflictos, persistir notas cortas, proteger rutas críticas y, después, liberar.

Related MCP server: agent-coord

Instalación

stdio (cualquier cliente 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 sobre HTTP: POST /mcp. REST de conveniencia: /v1/* (1:1 con las herramientas MCP). Localhost no necesita token; los enlaces no locales requieren SESSION_COLLAB_HTTP_TOKEN y SESSION_COLLAB_ALLOWED_HOSTS (o --allowed-host). Se validan Host/Origin; /health usa las mismas comprobaciones (requiere bearer cuando hay un token configurado).

Plugin para Claude Code

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

Global: npm install -g session-collab-mcp

Repositorio local: ejecuta npm run install:local y luego apunta la configuración de MCP hacia dist/cli.js.

Flujo de trabajo

Úsalo solo para trabajo no trivial / multisesión.

1. collab_session_start — con el mismo name+proyecto reutiliza; restore_context por defecto false.

2. collab_claim action=create — reclama archivos por lotes; reclamación o bloqueo atómico; rutas normalizadas a project_root. check es solo una comprobación opcional (sonda).

3. collab_memory_save — solo notas cortas (≤800 caracteres; rechazadas si son más largas; no es una bóveda).

4. collab_claim action=release y luego collab_session_end.

list / status / la ruta normal de reclamación son compactos salvo si detail=true.

Prefiere las reclamaciones a nivel de símbolo al compartir un archivo. La superposición devuelve waiting_for_coordination o partial_claim_created.

Herramientas

| Herramienta | Propósito | mean| -------------------------------------------------------------- | ----------------------------------------------------------------------------- | | collab_session_start / _end / _list / _update | Registrar, finalizar, listar, heartbeat | | collab_config | Modo de conflicto y opciones de libriación autormática | | collab_status | Instantánea (contadores salvo que detail=true) | | collab_claim | create, check, release, list | | collab_memory_save / _recall / _clear | Memoria de trabajo (finding, decisión, esado, to do, important, context) | | collab_protect | register, check, list (planes y archivos creados) |

Cambios incompatibles de v2.0: MIGRATION.md. Historial completo: CHANGELOG.md. Informes de seguridad: SECURITY.md.

Datos

**

• **servidor SQLite es por machinemedio / usuario del SO (WAL, offline). Orden de búsqueda:

1. SESSION_COLLAB_DB si está definida.

2. ~/.session-collab/collab.db si ya existe.

3. ~/.claude/session-collab/collab.db (legacy) si ya existe.

4. De lo contrario, crea ~/.session-collab/collab.db.

collab_session_start devuelve scope:... y db_path. El plugin PreToolUse de Claude Code deniega Write/Edit sobre archivos reclamados por otra sesión (SESSION_COLLAB_HOOK_DISABLE=1 para omítir esa comprobación).

Desarrollo

Node.js 18+ (o superior). 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

Empaquetado opcional heredado: SESSION_COLLAB_INCLUDE_LEGACY=true npm run build (no está en la lista de herramientas de v2).

Relacionados

• lazy-desktop-mcp

• lazy_mobile_mcp

• lazy-media-mcp

Licencia

[@2e2048.en-US]© leaf304

MIT © leaf76