用途:在 TrueFoundry 上注册和管理 MCP 服务器,支持三类独立清单——远程服务器、虚拟(组合)服务器、OpenAPI 转 MCP 包装。适用于连接已有 MCP 端点、将多个服务器组合为虚拟服务器、或将 OpenAPI 规范包装为 MCP 服务器。
主要能力:可列出、查看、注册和删除 MCP 服务器;远程服务器支持 streamable-http 与 SSE 传输,并提供 header、oauth2、passthrough 三种鉴权方式及可选 TLS 设置;虚拟服务器可组合多个已注册服务器并过滤工具;OpenAPI 服务器支持远程或内联规范,最多派生 30 个工具。
使用方式:可通过工具调用(如 tfy_mcp_servers_list、tfy_mcp_servers_delete)或直接 API 操作,直接 API 需先设置 TFY_API_SH 指向本技能的 scripts/tfy-api.sh。注册可用 CLI(tfy apply -f 文件名)或直接 API(如 $TFY_API_SH PUT /api/svc/v1/apps "$(cat 文件名 | yq -o json)")。列表可通过 $TFY_API_SH GET /api/svc/v1/mcp-servers 获取。
安全限制:所有凭证(API 令牌、OAuth 密钥、TLS 证书)必须使用 tfy-secret:// 引用,不得在清单中嵌入原始凭证;代理不得回显、记录或显示原始凭证值。使用新外部 URL 前需用户明确确认,远程 OpenAPI 规范应来自可信来源,敏感环境建议使用内联规范。
其它限制:stdio 型 MCP 服务器无法直接注册,需先用 mcp-proxy 等包装为 HTTP 后再注册;删除操作需要人工批准(HITL);OpenAPI 规范超过 30 个工具会报错。