Trellis MCP

🚀 Trellis MCP 服務器

Trellis MCP 提供了 AI 助手與 Trellis 之間的接口，藉助 模型上下文協議 (MCP) 實現集成。

🚀 快速開始

先決條件

• 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 集成：一個輕量級且開源的文本轉 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")

🆘 問題與支持

如需幫助或報告問題，請訪問 GitHub 倉庫 提交 ISSUE。

貢獻

歡迎貢獻！請參考 CONTRIBUTING.md 文件瞭解如何參與此項目。