Consolidation Engine MCP 服务器
使用说明
-
项目简介
- 该项目实现一个完整的 MCP 服务器端,结合文档合并、计划管理、冲突检测与解析等功能,面向 LLM 客户端提供标准化的上下文信息与功能调用能力。通过 MCP 标准的 JSON-RPC 风格请求响应来处理工具调用、获取工具列表、以及渲染与提供 Prompts。
-
主要功能点
- 4 层架构支持:
- MCP stdio(命令行/集成环境对接)
- InterLock UDP Mesh(端口 3032,用于分布式服务器协作)
- HTTP REST API(端口 8032,提供状态、历史、计划、冲突等资源访问)
- WebSocket 事件(端口 9032,提供实时通知)
- 工具与 Prompts 支持
- 提供一组工具用于生成并验证合并计划、执行文档合并、检测与解决冲突、获取历史等
- 数据持久化
- 使用 SQLite 数据库持久化计划、操作与冲突等数据
- 实时事件与监控
- 通过 WebSocket 实时推送合并、冲突等事件
- 面向 MCP 客户端的标准化交互
- 通过 MCP Server 提供 ListTools 与 CallTool 的 JSON-RPC 请求处理能力
- 4 层架构支持:
-
安装步骤
-
- 克隆仓库后进入项目根目录
-
- 运行 npm install
-
- 运行 npm run build/ 编译(如需要)
-
- 启动服务器(通常通过 npm start,依据 README 的指引)
-
-
服务器配置(MCP 客户端使用的配置信息)
- MCP 客户端需要知道要连接的 MCP 服务器的启动命令与参数,以便建立与 MCP 服务器的会话。以下为示例字段说明,实际值需按部署环境填写:
- server name(服务器名称): consolidation-engine
- command(启动命令): node
- args(启动参数): 路径指向编译输出的入口文件,例如 "/path/to/consolidation-engine/dist/index.js"
- 注:该配置用于客户端自动化接入 MCP 服务器,客户端本身并不需要该服务器端的实现细节,只需要知道启动命令与参数即可连接到 MCP 服务器。
- MCP 客户端需要知道要连接的 MCP 服务器的启动命令与参数,以便建立与 MCP 服务器的会话。以下为示例字段说明,实际值需按部署环境填写:
-
基本使用方法
- 启动与对接
- 使用 MCP 客户端配置好的启动命令启动客户端,让其连接到 Consolidation Engine 服务器。
- 常用操作
- 列出可用工具(ListTools)
- 调用具体工具(如 create_merge_plan、validate_plan、merge_documents、detect_conflicts、resolve_conflicts、get_merge_history)
- 通过 HTTP/WS/UDP InterLock 观察实时事件与状态
- 运行环境
- 服务器具备 Node.js 运行环境,依赖的中间件与端口需按配置开放
- 启动与对接