Cubis Foundry MCP Server

使用说明

• 项目简介

  • 该仓库实现了一个完整的 MCP 服务器端，核心功能包括：托管并管理资源、注册和执行 Tools、定义并渲染 Prompt 模板，以及通过 JSON-RPC 与客户端通信。服务器支持 STDIO 与 Streamable HTTP（HTTP 转 transport）等传输方式，具备会话管理和多路复用能力，方便将上下文、工具和提示模板暴露给 LLM 客户端。

• 主要功能点

  • 资源与技能管理：从 Vault 扫描技能指针，提供资源元数据，支持技能浏览与检索。
  • Tools 注册与执行：内置工具通过 declarative registry 注册，外部上游（Postman、Stitch）工具通过透传实现，所有工具通过 JSON-RPC 调用。
  • Prompt/模板渲染：支持设计系统风格的模板输出、按页面覆写规则输出页面特定内容，提供设计系统 MASTER 与覆盖页面。
  • JSON-RPC 通信：遵循 MCP 的 JSON-RPC 请求/响应格式，统一返回结果或错误信息。
  • 多传输协议与会话：STDIO（本地调试/容器内直接调用）和 HTTP（多会话，内部实现多会话 HTTP Server），兼容 SSE/WebSocket 等扩展场景。
  • 配置与网关集成：内置 cbxConfig、gateway、mcp-manifest、catalog 等模块，支持对外部服务的透传与自发现。

• 安装步骤

  • 安装前提：需要 Node.js 运行环境，编译输出已包含在 dist 目录中，直接执行编译后的 CLI。
  • 构建与安装（简要）：
    • 安装并构建项目的依赖与编译产物（通常包含 npm install 与 npm run build/编译命令，具体步骤以仓库自带脚本为准）。
    • 生成可执行入口，如 cubis-mcp，用于启动 MCP 服务器。
  • 启动方式示例（按仓库实现的入口点可选传输方式）：
    • STDIO 模式：直接在本地启动以 STDIO 方式对接客户端。
    • HTTP 模式：使用 Streamable HTTP 传输，容器环境下可通过端口暴露 HTTP 接口供远端客户端连接。
  • 运行时依赖：若启用透传上游工具，需正确配置 cbx_config.json（全局/项目作用域），以及 Postman/Stitch 的 API 密钥环境变量。

• 服务器配置（MCP 客户端需要的最小信息） 配置以 JSON 表示，描述 MCP 服务器的启动入口与参数，便于 MCP 客户端建立连接。示例（描述性注释，非代码块展示）： { "server": { "name": "cubis-foundry-mcp", "version": "0.1.0", "description": "Cubis Foundry MCP Server" }, "command": "cubis-mcp", "args": [ "--transport", "stdio" // 若要使用 STDIO 传输，客户端需使用该命令与参数建立连接 // 也可切换为 "--transport http" 配合后续 host/port 配置实现多会话 HTTP 访问 ], "transport": { "default": "stdio" // 服务器默认传输方式 } } 说明：

  • server.name 与 server.version 对应服务器识别信息，客户端据此了解服务端版本和能力。
  • command 与 args 组成客户端启动时用来连接 MCP 服务器的入口命令及参数。实际连接时，客户端只需要依据该信息启动并通过指定传输方式连线。
  • 如需 HTTP 访问，请将 transport 设置为 http，并提供 host/port 等网络参数（具体实现请参照实际部署脚本与环境变量）。MCP 客户端不需要附带敏感凭据；凭据配置通过 cbx_config.json 管理并由网关/透传机制处理。