MCP 服务
用 Model Context Protocol 将 AI Agent 连接到 Trellis 2
MCP 服务
Trellis 2 提供了 Model Context Protocol (MCP) 服务,让 AI Agent——Claude Code、Cursor、Codex CLI、Windsurf 以及任何兼容 MCP 的客户端——可以在对话中直接生成 3D 模型。
MCP 服务复用你现有的 API Key 和积分,无需单独注册。
- 服务地址:
https://trellis2.app/api/mcp - 传输协议: Streamable HTTP(无状态)
- 认证方式:
Authorization: Bearer tr_...(与 REST API 同一把 Key)
快速开始
在 设置 → API Keys 创建 API Key。
在 Agent 中注册服务。以 Claude Code 为例:
claude mcp add trellis2 --transport http https://trellis2.app/api/mcp \
--header "Authorization: Bearer tr_你的key"其他客户端把同样的 URL 和 Header 加进各自的 MCP 配置即可。标准 JSON 格式:
{
"mcpServers": {
"trellis2": {
"type": "http",
"url": "https://trellis2.app/api/mcp",
"headers": {
"Authorization": "Bearer tr_你的key"
}
}
}
}对 Agent 说:"列出可用的 3D 模型"——Agent 会调用 list_models,连接即已打通。
工具
| 工具 | 功能 |
|---|---|
list_models | 列出可用的 3D 生成模型,含积分成本与能力标签 |
generate_3d_model | 从图片 URL 或文本提示发起 3D 生成任务,原子预扣积分 |
get_task | 轮询任务状态与进度;完成后返回网格 / 贴图 / 预览的下载地址 |
典型流程:list_models → generate_3d_model → 轮询 get_task 直到 COMPLETED → 从输出地址下载模型。
生成失败会自动退还积分——与 REST API 同样的保障。