Session Collab MCP

프로바이더에 구애받지 않는 MCP 서버로서, 다중 에이전트 / 다중 세션 작업을 지원합니다: 파일 선점, 단기 작업 메모리, 경로 보호, 충돌 감지.

stdio 또는 HTTP JSON-RPC를 통해 Claude Code, Codex, Grok, Cursor 및 기타 MCP 클라이언트와 함께 작동합니다. 선택적 Claude Code 패키징: plugin/.

왜

동일 머신 전용 — 원격 Git 잠금이 아닙니다. 하나의 OS 사용자에서 병렬 코딩 세션은 공유된 “작업 의도”가 없기 때문에 서로를 덮어씁니다. 이 서버는 로컬 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-over-HTTP: POST /mcp. 편의 REST: /v1/* (MCP 도구와 1:1). 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 / 선점 정상 경로는 detail=true가 아니면 간결합니다.

파일을 공유할 때는 심볼 수준 선점을 선호하세요. 겹침이 발생하면 waiting_for_coordination 또는 partial_claim_created를 반환합니다.

도구

v2.0 주요 변경 사항: MIGRATION.md. 전체 이력: CHANGELOG.md. 보안 보고: SECURITY.md.

데이터

SQLite는 머신 / OS 사용자별입니다(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