使用说明（快速上手）

• 项目简介

  • 该仓库实现了一个完整的 MCP 服务器端，能够托管资源、注册并执行工具（Tools）、定义与渲染 Prompt 模板，并通过 JSON-RPC 与 LLM 客户端进行交互。服务器支持多种传输方式（如 STDIO、HTTP 的多会话模式），并实现了对外部代理（Postman/Stitch）的 passthrough，以及对内置工具的 declarative 注册。

• 主要功能点

  • 内置工具注册与执行：通过工具注册表（Tool Registry）自动注册一组内置工具，并暴露给客户端调用。
  • 动态上游 passthrough：通过 upstream/passthrough 自动发现并暴露 Postman、Stitch 的工具，允许 MCP 客户端调用外部服务的工具。
  • Vault 探测与描述：扫描技能库（vault）以产生描述、分类、字节统计等清单供浏览与检索。
  • 资源与技能管理：提供读取资源、读取技能内容、读取技能引用、读取描述等能力。
  • 资源预算与度量：提供 token budget 估算、性能、成本等指标，便于调优。
  • 多传输与多会话：支持 stdio 与可扩展的 streamable http (多会话) 传输，适合容器化环境并发接入。
  • 配置系统整合：通过 cbxConfig、gateway、mcp gateway 等模块实现复杂的凭证、网关、及上下游集成。

• 安装与运行步骤（简要）

  • 安装依赖：在仓库根目录执行 npm install（或按照仓库提供的安装方式）。
  • 构建/启动：执行 mvn/ts 构建产物后，通过以下任一方式启动 MCP 服务器：
    • stdio 模式（默认，直接在当前进程内与客户端通过标准输入输出通信）；
    • http 模式（通过 HTTP 的多会话传输提供可扩展的 JSON-RPC 端点）。
  • 参考命令：服务器启动命令会在客户端启动时使用，例如 cubis-mcp --transport stdio --scope auto。更多启动选项可通过 cubis-mcp --help 查看。

• 服务器配置（供 MCP 客户端使用的启动信息，JSON 格式） { "serverName": "cubis-foundry-mcp", "serverVersion": "0.1.0", "command": "cubis-mcp", "args": [ "--transport", "stdio", "--scope", "auto" ], "notes": "示例启动信息。若需要通过 HTTP 端口对外暴露，请将 --transport 设置为 http，并在 args 中提供 --host 与 --port。" } 说明：

  • 该配置用于 MCP 客户端了解服务器的启动命令与参数，便于在自动化环境中按需启动与连接。
  • 实际部署时，请确保上游凭据、Vault 路径、以及工作负载配置与运行环境相匹配。