wip MCP

MCPAI代理

提供方 leaf76

AI代理 未标注 Token 社区 / 第三方 Claude

一个提供者无关的模型上下文协议(MCP)服务器,用于防止多个代理会话同时处理同一代码库时的冲突。

一句话选型结论

按资料字段整理

wip MCP 属于AI代理类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 10 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量10暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

多代理协作TypeScript本地部署冲突解决代码库管理工作流同步上下文持久化

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 10 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 10 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
wip MCP当前 10 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方leaf76上游标注的维护方 leaf76
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.9 KB
来自项目仓库与上游目录的原文,未做删改

会话领MCP

一种与提供者无关的模型上下文协议(MCP)服务器,当多个代理会话同时在同一代码库上工作时,可以防止冲突。

问题

使用并行编码代理会话或多代理工作流时:

  • 会话A正在重构一些代码
  • 会话B不知道并认为代码“有问题”-删除或还原它
  • 会话A的工作消失

根本原因:会话之间没有“工作意图”的同步机制。

解决方案

会话协作MCP提供 在制品(WIP)注册表 这允许会话:

  1. 声明 -宣布要修改的文件
  2. 检查 -验证没有其他会话正在处理相同的文件
  3. 坚持 -保存在上下文压缩后仍然存在的上下文
  4. 保护 -保护关键文件免受意外更改
  5. 发布 -完成后免费提供文件

定位

session-collab-mcp 有两层:

  • 核心服务器:通过stdio或HTTP JSON-RPC提供与提供者无关的MCP服务器
  • 可选集成:提供程序特定的打包,例如中的Claude Code插件 plugin/

核心服务器应该是默认的心智模型。Claude Code是一个集成目标,而不是产品边界。

安装

选项1:通过stdio的通用MCP客户端

将此功能用于任何可以启动本地stdio服务器的MCP客户端:```json
{
"mcpServers": {
"session-collab": {
"command": "npx",
"args": ["-y", "session-collab-mcp@latest"]
}
}
}


确切的配置包装器取决于您的MCP客户端,但服务器契约是相同的。

### 选项2:HTTP服务器+CLI

当您的客户端更喜欢MCP而不是HTTP JSON-RPC时,或者当您想要一个通用的shell友好包装器时,请使用此选项:```bash
# Start HTTP server
session-collab-http --host 127.0.0.1 --port 8765

# CLI wrapper (convenience REST client)
session-collab health
session-collab tools
session-collab call --name collab_session_start --args '{"project_root":"/repo","name":"demo"}'

对于MCP over HTTP客户端,请使用 POST /mcp 使用JSON-RPC请求。这 /v1/* 端点是轻量级自动化和shell使用的便利REST外观。

选项3:Claude代码插件(可选集成)

仅当Claude Code是您的MCP客户端并且您需要自动服务器设置、挂钩和技能时,才作为Claude Code插件安装:```bash

Add marketplace

/plugin marketplace add leaf76/session-collab-mcp

Install plugin

/plugin install session-collab@session-collab-plugins


该插件包括:

- **MCP服务器**:自动配置
- **钩子**:会话启动、停止和预压缩提醒
- **技能**: `collab-start` 用于完全初始化
- **命令**: `/session-collab:status` 和 `/session-collab:end`

### 选项4:全局安装```bash
npm install -g session-collab-mcp

特性

引导式会话工作流

MCP工具为您提供跨提供商的稳定协作工作流程:

  1. 开始会话 collab_session_start
  2. 检查文件 collab_claim(action="check")
  3. 使用以下方式保留文件 collab_claim(action="create")
  4. 使用保存重要上下文 collab_memory_save
  5. 以结束会话 collab_session_end

工作记忆

在上下文压缩中幸存下来的上下文持久性:

  • 研究结果:错误根源、调查结果
  • 决策:架构选择、设计决策
  • 状态:当前实施状况
  • 待办事项:行动项目和任务
  • 重要:要保存的关键信息
  • 上下文:会议背景

文件保护

保护重要计划文件或创建的文件免受意外删除:

  • 向注册受保护的计划 collab_protect(action="register", type="plan", ...)
  • 使用注册创建的文件 collab_protect(action="register", type="file", ...)
  • 在删除或替换文件之前检查保护状态

冲突处理模式

使用配置行为 collab_config:

模式 行为
strict 始终询问用户,绝不绕过
smart (默认) 自动继续使用安全内容,请求屏蔽
bypass 尽管存在冲突,仍继续(仅警告)

自动释放选项

选项 默认值 描述
auto_release_immediate false 编辑/写入后自动释放索赔
auto_release_stale false 自动释放索赔超过阈值
stale_threshold_hours 2 索赔被视为过期前的几个小时
auto_release_delay_minutes 5 过期发布的宽限期

MCP工具参考

会话管理(5个工具)

工具 目的
collab_session_start 注册新会话
collab_session_end 结束会话并释放所有索赔
collab_session_list 列出活动会话
collab_config 配置会话行为
collab_status 获取会话状态摘要

索赔(1个统一工具)

工具 操作
collab_claim create, check, release, list (检查: exclude_self 默认为true)

工作记忆(3个工具)

工具 目的
collab_memory_save 保存上下文(追加销售)
collab_memory_recall 回忆上下文
collab_memory_clear 清晰的记忆

保护(1个统一工具)

工具 操作
collab_protect register, check, list

状态监控

工具 目的
collab_status 统一会话状态

HTTP API(v1)

/v1/* 端点1:1映射到MCP工具,并返回JSON响应 trace_id 关于失败:

  • POST /v1/sessions/start → collab_session_start
  • POST /v1/sessions/end → collab_session_end
  • GET /v1/sessions → collab_session_list
  • POST /v1/config → collab_config
  • GET /v1/status → collab_status
  • POST /v1/claims → collab_claim (创建)
  • POST /v1/claims/check → collab_claim (检查)
  • POST /v1/claims/release → collab_claim (释放)
  • GET /v1/claims → collab_claim (列表)
  • POST /v1/memory/save → collab_memory_save
  • POST /v1/memory/recall → collab_memory_recall
  • POST /v1/memory/clear → collab_memory_clear
  • POST /v1/protect/register → collab_protect (注册)
  • POST /v1/protect/check → collab_protect (检查)
  • GET /v1/protect/list → collab_protect (列表)
  • POST /v1/tools/call / GET /v1/tools (通用访问)

基于HTTP的MCP

  • POST /mcp 接受JSON-RPC initialize, tools/list,以及 tools/call 请求:
  • GET /mcp 当前返回一个明确的“不支持流”响应,而不是假装是完整的流式HTTP SSE
  • 本地主机绑定强制执行主机和源验证
  • 非本地绑定需要两者 SESSION_COLLAB_HTTP_TOKEN 以及允许的主机列表 SESSION_COLLAB_ALLOWED_HOSTS 或重复 --allowed-host

使用示例

基本工作流程```bash

Session A starts working

collab_session_start(project_root="/my/project", name="feature-auth")
collab_claim(session_id="session-a", action="create", files=["src/auth.ts"], intent="Adding JWT support")

Session B checks before editing

collab_claim(session_id="session-b", action="check", files=["src/auth.ts"])

Result: "CONFLICT: src/auth.ts is claimed by 'feature-auth'"

If you want to include your own claims in the check

collab_claim(session_id="session-a", action="check", files=["src/auth.ts"], exclude_self=false)

Session A finishes

collab_claim(session_id="session-a", action="release", claim_id="...")


### 工作记忆```bash
# Save a finding
collab_memory_save(
session_id="abc123",
category="finding",
key="auth_bug_root_cause",
content="Missing token validation in refresh flow",
priority=80
)

# Recall active memories
collab_memory_recall(session_id="abc123", active=true)

文件保护```bash

Protect a plan document

collab_protect(
action="register",
session_id="abc123",
type="plan",
file_path="docs/feature-plan.md",
title="Feature plan",
content_summary="Steps, risks, and rollout notes"
)

Check before editing

collab_protect(
action="check",
session_id="abc123",
file_path="docs/feature-plan.md"
)

Result: "Protected (plan). Confirm before deleting."


### 状态监控```bash
# Get session status
collab_status(session_id="abc123")
# Result: {
#   session: { id: "abc123", name: "feature-auth", status: "active" },
#   claims: [...],
#   other_sessions: 1,
#   message: "Session active. 2 claim(s), 5 memories."
# }

从v1.x迁移

2.0版通过简化的API引入了突破性的更改。看 MIGRATION.md 有关详细的迁移说明。

关键变化

  • 工具整合:50多种工具→ 10 核心工具
  • 基于动作的界面:具有多个操作的单个工具
  • 简化响应:更简洁、更平坦的响应格式
  • 已删除功能:LSP集成、消息传递、通知、排队

数据存储

所有数据都存储在本地 ~/.claude/session-collab/collab.db (SQLite)。

  • 无需远程服务器
  • 本地主机HTTP使用在没有API令牌的情况下有效
  • 非本地HTTP绑定需要 SESSION_COLLAB_HTTP_TOKEN
  • 离线工作
  • 使用WAL模式实现多过程安全

发展

先决条件

  • Node.js 18+
  • npm或纱线

设置```bash

npm install
npm run build


### 传统版本(可选)

传统模式/查询不在默认捆绑包中。要包含旧版条目以实现兼容性,请执行以下操作:```bash
SESSION_COLLAB_INCLUDE_LEGACY=true npm run build

维护说明:遗留导出仅用于向后兼容性,不会在v2工具列表中公开。

脚本```bash

npm run build # Build with tsup
npm run start # Start the MCP server
npm run start:dev # Start in development mode
npm run typecheck # Run TypeScript type checking
npm run lint # Run ESLint
npm run test # Run tests with Vitest


### HTTP集成测试

HTTP集成测试需要本地侦听端口。请使用以下命令启用它们:```bash
SESSION_COLLAB_HTTP_TESTS=true npx vitest run src/http/__tests__/server-integration.test.ts

历史笔记

下面的变更日志条目记录了历史里程碑,包括在当前v2 API之前删除的工具和工作流。将上述工具表和示例视为当前公共表面的真实来源。

项目结构```

session-collab-mcp/
├── bin/ # Executable entry point
├── migrations/ # SQLite migration files
├── plugin/ # Optional Claude Code integration
├── src/
│ ├── cli.ts # CLI entry point
│ ├── constants.ts # Version and server instructions
│ ├── db/ # Database layer
│ ├── mcp/ # MCP protocol implementation
│ │ ├── tools/ # Tool implementations
│ │ │ ├── session.ts # Session management
│ │ │ ├── claim.ts # File/symbol claims
│ │ │ ├── memory.ts # Working memory
│ │ │ └── protection.ts # File protection
│ │ └── ...
│ └── utils/
└── package.json
```

更新日志

v2.1.0

  • 添加HTTP服务器+CLI包装器,以实现通用的AI CLI使用
  • 添加HTTP API端点和utils测试
  • 为已弃用的模式/查询添加旧条目(可选构建)
  • 提高索赔冲突的准确性和发布摘要
  • 扩展MCP工具和DB流的测试覆盖范围

v2.0.0(中断)

  • 主要简化:从50多种工具减少到10种核心工具
  • 基于行动的设计:具有操作参数的统一工具
  • 已删除功能:LSP集成、消息传递、通知、排队、决策跟踪
  • 改进的性能:更快的启动速度和更低的复杂性
  • 更好的测试:所有工具操作的全面测试覆盖
  • 迁移指南:v1.x的详细升级路径

v0.8.0

  • 添加工作记忆系统以实现上下文持久化(collab_memory_* 工具)
  • 添加计划保护(collab_plan_register, collab_plan_update_status)
  • 添加文件保护(collab_file_register, collab_file_check_protected)
  • 记忆类别:发现、决策、状态、待办事项、重要、上下文
  • 固定的记忆在上下文压缩中幸存下来
  • 计划生命周期:草稿→ 批准→ 正在进行中→ 完成→ 归档

v0.7.1

  • 添加 collab_auto_release 编辑后发布索赔的工具
  • 添加自动发布配置选项: auto_release_immediate, auto_release_stale
  • 添加 cleanupStaleClaims() 用于自动清除过期索赔
  • 添加PostTool使用钩子提醒编辑/写入后自动释放

v0.7.0

  • 为索赔添加优先级系统(0-100,级别:严重/高/正常/低)
  • 添加索赔队列系统(collab_queue_join, collab_queue_leave, collab_queue_list)
  • 添加通知系统(collab_notifications_list, collab_notifications_mark_read)
  • 添加审计历史跟踪(collab_history_list)
  • 添加 collab_claim_update_priority 紧急工作不断升级

v0.6.0

  • 使用复合索引优化数据库查询
  • 提取共享实用程序(加密、响应构建器)
  • 删除未使用的身份验证和令牌模块
  • 使用预编译的JS,启动速度提高15倍
  • 修复多值查询的GROUP_CONCAT分隔符
  • 跨工具添加统一的Zod验证

v0.5.0

  • 添加参考跟踪和影响分析(第3阶段)
  • 添加符号级声明和LSP集成
  • 修复多进程MCP服务器的SQLite WAL同步问题
  • 添加 collab_config 冲突处理模式工具

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
wip MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

wip MCP 怎么在 Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

wip MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

wip MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

wip MCP 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

wip MCP 能提供哪些能力?

资料显示约 10 个工具;能力标签包括 多代理协作、TypeScript、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。