Trellis MCP

🚀 Trellis MCP 服务器

Trellis MCP 提供了 AI 助手与 Trellis 之间的接口，通过 模型上下文协议 (MCP) 实现集成。该项目为 3DAIGC（三维人工智能生成内容）领域带来了新的解决方案，能够实现文本转 3D 图像以及图像转 3D 模型等功能。

🚀 快速开始

先决条件

• Python 3.10+
• Blender
• Trellis Blender 插件
• Trellis API 后端
• Claude / Cursor（建议）/ Windsurf

安装

1. Trellis Blender 插件

1. 从 这里 下载 Trellis Blender 插件。
2. 打开 Blender -> 编辑 -> 偏好设置 -> 添加插件 -> 从文件安装 -> 选择下载的插件 -> 安装。
3. 在 3D 视图中 -> 视图 3D > 侧边栏 > TRELLIS -> 启动 MCP 服务器。

2. 配置 API 后端

由于 Trellis 是一个开源的文本转 3D 模型，你需要根据 README 自行部署 Trellis API 后端。

# 克隆一个 API 分支的 trellis
git clone https://github.com/FishWoWater/TRELLIS
# cd 到 TRELLIS 目录后执行以下命令：
python manage.py runserver

3. 安装 Python 包

在终端中运行以下命令以安装所需的 Python 包：

pip install trellis-mcp

配置示例

启动 MCP 服务器

打开 Blender 并启动 Trellis 插件中的 MCP 服务器。

✨ 主要特性

此项目展示了非常 基础 的 MCP 与 Trellis 集成，Trellis 是一个轻量级且开源的文本转 3D 图像/图像转 3D 模型的 3DAIGC 模型。与其他现有的 Rodin 在 Blender - MCP 中的集成 和 [TriPo 集成](https://github.com/VAST - AI - Research/tripo-mcp) 相比，它具有以下优势：

• 更快且内存高效：你可以使用 本地部署 Trellis（只需 8GPU + 显存），并且可以在仅需 ~15s 的时间（更多显存可缩短至 10s）内从文本生成带纹理的网格。
• 免费：你无需支付 Rodin/Meshy/TriPo 等昂贵 API 的费用。

但具有以下限制：

• Trellis 是开源的，没有现成的 API 提供商可用，你需要自己部署（参考 README）。
• API/Prompt 尚未经过全面测试/调优，可能存在稳定性问题。

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

📺 演示

一个生成单个对象的最小演示，更复杂的提示与 Blender - MCP 的集成正在优化中。

💻 使用示例

基本用法

1. 在 Blender 中启用 Trellis 插件。
2. 打开 MCP 服务器。
3. 使用你的 AI 助手通过 MCP 协议与 Trellis 进行交互。

高级用法

• 支持自定义网格生成参数。
• 可扩展的插件架构以支持更多功能。

代码示例

创建基本网格

from trellis.mcp import GridGenerator

# 创建一个简单的立方体网格
grid = GridGenerator.create_cube(length=1.0, width=1.0, height=1.0)

应用纹理

from trellis.mcp import TextureApplicator

# 将纹理应用于网格
TextureApplicator.apply_texture(grid, texture_path="path/to/texture.png")

📚 详细文档

功能

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

发展计划

目前暂未提及具体的发展计划，后续可关注项目更新。

❓ 问题与支持

如需帮助或报告问题，请访问 GitHub 仓库 提交 ISSUE。

贡献

欢迎贡献！请参考 CONTRIBUTING.md 文件了解如何参与此项目。