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-over-HTTP：POST /mcp。便捷 REST：/v1/*（与 MCP 工具一一对应）。本地主机无需令牌；非本地绑定需要 SESSION_COLLAB_HTTP_TOKEN 和 SESSION_COLLAB_ALLOWED_HOSTS（或 --allowed-host）。主机/来源会被验证；/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 是 每台机器 / 每个操作系统用户（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 会拒绝写入/编辑被其他会话声明的文件（设置 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