🚀 Trellis MCP 服务器
Trellis MCP 提供了 AI 助手与 Trellis 之间的接口，通过 模型上下文协议 (MCP) 实现集成。该项目为 3DAIGC（三维人工智能生成内容）领域带来了新的解决方案，能够实现文本转 3D 图像以及图像转 3D 模型等功能。
🚀 快速开始
先决条件
- Python 3.10+
- Blender
- Trellis Blender 插件
- Trellis API 后端
- Claude / Cursor（建议）/ Windsurf
安装
1. Trellis Blender 插件
- 从 这里 下载 Trellis Blender 插件。
- 打开 Blender -> 编辑 -> 偏好设置 -> 添加插件 -> 从文件安装 -> 选择下载的插件 -> 安装。
- 在 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 的集成正在优化中。
💻 使用示例
基本用法
- 在 Blender 中启用 Trellis 插件。
- 打开 MCP 服务器。
- 使用你的 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 文件了解如何参与此项目。