README

Trellis MCP 服务器

Trellis MCP 通过模型上下文协议 (MCP) 提供 AI 助手和 Trellis 之间的接口。

免责声明

本项目展示了 MCP 与 Trellis 的一个非常最小化的集成：一个轻量级且开源的 text-to-3d/image-to-3d 3DAIGC 模型。与现有的 blender-mcp 中的 rodin 集成和 tripo 集成相比，它具有以下优点：

更快且内存效率更高：您可以在本地仅使用 8GPU+ VRAM 部署 TRELLIS，并且仅需 ~15 秒（更多显存时为 10 秒）即可从文本生成带纹理的网格。
免费：您无需支付 Rodin/Meshy/Tripo 昂贵的 API 费用。

但它有以下限制：

Trellis 是开源的，没有现成的 API 模型提供商，您必须自己部署它（请参阅 README）。
API/Prompt 尚未经过充分测试/调整，可能存在稳定性问题。

因此，请您自行承担使用风险。

演示

一个生成单个对象的最小演示，使用 blender-mcp 的更复杂的提示正在调整中。

Demo

功能

[x] 使用 Trellis API 从自然语言（文本）生成 3D 资产并导入到 Blender 中
[ ] 使用 Trellis API 从自然语言（文本）为给定的 3D 网格生成纹理/材质并导入到 Blender 中

路线图

前提条件

Python 3.10+
Blender
Trellis Blender 插件
Trellis API 后端
Claude / Cursor(推荐) / Windsurf

安装

1. Trellis blender 插件

从此处下载 Trellis Blender 插件
打开 Blender -> 编辑 -> 偏好设置 -> 插件 -> 从文件安装 -> 选择下载的插件 -> 安装
在 3D 视口 -> View3D > 侧边栏 > TRELLIS -> 启动 MCP 服务器

2. 配置 API 后端

由于 trellis 是一个免费的开源 text-to-3d 模型，您需要参考 README 部署您自己的 trellis API 后端

# 克隆一个 trellis 的 API 分支
git clone https://github.com/FishWoWater/TRELLIS
cd TRELLIS

# 编辑 trellis_api/config.py 中的 BACKEND URL

# 配置文本工作者的数量并启动 ai 工作者
# 不需要图像工作者
python trellis_api/ai_worker.py --text-workers-per-gpu 1 --image-workers-per-gpu 0

# 启动 web 服务器
python trellis_api/web_server.py

# 或在 windows 本地开发
python trellis_api/web_server_single.py

3. 在 Windsurf/Cursor/Claude 上配置 MCP 服务器

{
    "mcpServers": {
        "trellis-blender": {
            "command": "uvx",
            "args": [
                "trellis-mcp"
            ]
        }
    }
}

鸣谢

主干和大脑：Trellis
灵感：blender-mcp
借鉴了很多代码 Tripo MCP Service

Trellis MCP Server