CLEO MCP 服务端

使用说明:

  • 项目简介 CLEO 的 MCP 服务端实现为大语言模型(LLM)提供统一的上下文和能力服务。它负责托管与管理可读写的资源(Resources)、注册并执行工具(Tools)、以及定义和渲染 Prompt 模板(Prompts),通过 JSON-RPC 与客户端进行通信,支持会话、能力声明和跨工具的上下文上下文集成。
  • 主要功能点
    • 提供资源、工具、Prompt 的标准化访问与管理,允许 LLM 通过 JSON-RPC 读取资源、调用工具、获取并渲染提示模板。
    • 支持会话管理、能力声明以及对客户端能力的自描述。
    • 通过多种传输方式与客户端通信(包括但不限于标准输入输出、Server-Sent Events、WebSocket 等,按实现细节在部署中启用)。
    • 自动化集成与部署脚本:内置安装与启动逻辑,配套 CAAMP 与 MCP 的安装脚本,方便在工具链中自动化接入。
    • 与 CLEO 平台的其他子系统耦合:BRAIN/NEXUS/LAFS 等,形成可持续扩展的上下文服务框架。
  • 安装步骤
    1. 确保 Node.js 环境就绪。
    2. 安装 CLEO 套件(推荐全局安装以获取 MCP 服务能力),如使用 npm 全局安装命令。
    3. 运行安装/配置流程以使 MCP 服务端就绪(仓库中提供 mcp-install、bin/postinstall 等 hooks,可自动探测并配置工具提供者)。
    4. 启动 MCP 服务:在支持的 CLI/脚本中执行相应启动命令(具体命令和参数在配置中描述)。
    5. 将 MCP 客户端与服务器对齐:根据配置将服务器名称、启动命令和参数填入 MCP 配置中,确保客户端能正确对接。
  • 服务器配置(供 MCP 客户端参考,不作为可执行代码展示) 服务器名称(serverName):cleo 启动命令(command):npx 启动参数(args):["-y", "@cleocode/cleo", "--mcp-server"] 说明:这是典型的服务器注册方式之一,亦可在全局安装场景下使用 ["cleo", "mcp"] 的参数组合。配置目的是帮助客户端知晓如何启动并连接到 MCP 服务器。 备注:MCP 客户端侧无需硬编码实现细节,只需要使用上述配置描述来建立连接。客户端会使用服务器名称、启动命令和参数来建立与 MCP 服务器的通信信道。
  • 基本使用方法
    • 客户端通过 JSON-RPC 请求向 MCP 服务器发起读取资源、调用工具、获取 prompts 等操作。
    • 服务器端负责接收请求、执行业务网关/域/操作(gateway/domain.operation),并返回规范化的 JSON-RPC 响应或通知。
    • 支持会话上下文管理、能力声明以及跨域资源的安全访问策略,确保多模型/多工具环境下的扩展性与安全性。

服务器信息