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 请求处理能力
  • 安装步骤

      1. 克隆仓库后进入项目根目录
      1. 运行 npm install
      1. 运行 npm run build/ 编译(如需要)
      1. 启动服务器(通常通过 npm start,依据 README 的指引)
  • 服务器配置(MCP 客户端使用的配置信息)

    • MCP 客户端需要知道要连接的 MCP 服务器的启动命令与参数,以便建立与 MCP 服务器的会话。以下为示例字段说明,实际值需按部署环境填写:
      • server name(服务器名称): consolidation-engine
      • command(启动命令): node
      • args(启动参数): 路径指向编译输出的入口文件,例如 "/path/to/consolidation-engine/dist/index.js"
    • 注:该配置用于客户端自动化接入 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 运行环境,依赖的中间件与端口需按配置开放

服务器信息