使用说明

项目简介
- Trinity 的 MCP 服务器是一个基于 FastMCP 的服务端组件，实现了模型上下文协议（MCP）的核心能力，向 MCP 客户端提供对资源、工具、系统、模板等的访问与执行能力，并支持跨代理的协作、系统部署、以及对话与任务执行的上下文管理。
- 主要面向需要将人机对话形成的上下文、工具调用、及资源访问标准化的 LLM 客户端/服务端场景，提供中心化的能力声明和统一的 JSON-RPC 风格交互。
主要功能点
- MCP 核心能力：暴露工具集（如 list_agents、get_agent、deploy_system、chat_with_agent 等）并通过 MCP 客户端进行调用；支持系统级与代理级权限模型，支持系统代理跨代理协作。
- 资源与凭证管理：支持对资源、凭据、环境变量等进行管理与注入，提供对 MCP 客户端的配置读取能力。
- 系统与多代理模板：能够基于 YAML/模板描述部署多代理系统，渲染并导出系统清单与清单的 YAML 表达。
- 文档与模板支持：文档工具、Agent 模板信息、以及环境变量替换等能力，方便 MCP 客户端了解可用模板及所需凭证。
- 安全与认证：可选开启的 API Key 认证，在 MCP 服务端进行 API 级鉴权，以保障跨系统调用的安全性。
- 多传输协议：支持 HTTP 流式传输（httpStream）或 STDIO 等传输方式，便于在不同环境中接入 MCP 客户端。
安装步骤（简要）
1. 准备环境
  - 安装 Node.js/TypeScript 的运行环境（建议使用 Node.js 版本与仓库要求相匹配）。
2. 获取代码
  - 获取仓库中的 mcp-server 相关代码：src/mcp-server 目录及其依赖。
3. 构建与运行
  - 安装依赖并编译/打包为可执行的服务端程序（如 ts 周边构建流程）、再启动 MCP 服务器。
  - 运行后服务端通常监听端口（例如 8080，具体端口可通过环境变量配置）。
4. 连接与使用
  - 使用 MCP 客户端连接到 MCP 服务器的指定端口、传输方式（httpStream 等）。
  - 根据 MCP 客户端的需求，提供相应的 API Key/凭据配置（若开启 key 认证），并按照 MCP 协议进行调用。
服务器配置（MCP 客户端需要的配置示例，客户端不需要）说明：以下为示例 JSON，描述 MCP 服务器的名称、执行命令及参数，以及运行时配置。请将其用于 MCP 客户端在连接时的配置展示示例，实际连接请按客户端要求提供。 { "server_name": "trinity-mcp", "command": "node", "args": ["dist/index.js"], "env": { "MCP_TRANSPORT": "httpStream", "MCP_PORT": "8080", "MCP_REQUIRE_API_KEY": "true" }, "notes": [ "server_name: MCP 服务器的唯一标识名称，用于在 MCP 客户端中区分不同的服务器", "command/args: 启动 MCP 服务器的执行命令及参数，客户端使用该信息建立连接并执行请求", "env: 运行时环境变量，控制传输类型、端口及认证策略", "需要 API Key 时，后台需要在请求中携带 Bearer token，客户端需配置 key" ] }
基本使用方法
- 连接与调用
  - 通过 MCP 客户端指定服务器名称、传输协议及认证方式，向服务器发起请求，获取资源、执行工具、或读取系统模板信息。
- 安全与权限
  - 根据是否开启 API Key 认证，MCP 客户端需要在请求头中携带有效的 API Key（Bearer token），或使用无密钥的开发模式进行测试（如禁用认证时）。
- 维护与扩展
  - MCP 服务器支持多工具注册、系统部署、模板查看等扩展点；可通过新增工具、扩展系统工具来扩展能力。

关键词

信息