Session Collab MCP

プロバイダー非依存のMCPサーバーで、マルチエージェント/マルチセッション作業をサポートします: ファイルのクレーム、短期作業メモリ、パスの保護、競合の検出。

stdioまたはHTTP JSON-RPCで、Claude Code、Codex、Cursor、その他のMCPクライアントと連携します。オプションのClaude Codeパッケージング: plugin/。

Why

同一マシンのみ — これはリモートGitロックではありません。1つのOSユーザーで複数のコーディングセッションを並行して行うと、共有の「作業意図」がないため、互いに上書きしてしまいます。このサーバーはローカルWIPレジストリです: ファイルを宣言し、競合をチェックし、短いメモを保持し、重要なパスを保護し、そして解放します。

Related MCP server: agent-coord

Install

任意の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-hosts)が必要です。Origin検証を実施。/healthエンドポイントはトークン設定時に同じチェックを行います。

Claude Code plugin

/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 にポイントします。

Workflow

並行作業が複雑な場合にのみ使用してください。

1. collab_session_start — 同じname+プロジェクトは再利用されます。restore_contextはデフォルトfalse

2. collab_claim action=create — ファイルを一括でクレーム。原子的なクレームまたはブロック。パスはproject_rootに正規化されます。checkはオプションのプローブのみ

3. collab_memory_save — 短いメモのみ(それ以上は拒否され、長すぎる場合は保存されません。ボールトではありません)

4. collab_claim action=release、その後collab_session_end

list / status / クレームの通常パスはdetail=trueでない限り簡潔です。

ファイル共有時はシンボルレベルでのクレームを推奨します。重複時はwaiting_for_coordinationまたはpartial_claim_createdを返します。

Tools

v2.0 の破壊的変更: MIGRATION.md。完全な履歴: CHANGELOG.md。セキュリティ報告: SECURITY.md。

Data

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 pluginのPreToolUseは、別セッションが書き込むファイルに対してWrite/Editを拒否します(SESSION_COLLAB_HOOK_DISABLE=1でスキップ)。

Development

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ツールリストには含まれません)。

Related

• lazy-desktop-mcp

• lazy_mobile_mcp

• lazy-media-mcp

License

MIT © leaf76