使用说明

项目简介

Trellis Blender MCP Server 是一个 MCP 服务器实现，它充当 AI 助手和 Blender 软件以及 Trellis 3D 生成 API 之间的桥梁。通过 MCP 协议，该服务器允许 AI 助手以标准化的方式与 Blender 进行交互，利用 Trellis 的文本到 3D 模型生成能力，并集成 PolyHaven 的海量 3D 资源，极大地扩展了 AI 助手在 3D 内容创作领域的应用能力。

主要功能点

文本到3D模型生成: 通过集成 Trellis API，支持 AI 助手根据自然语言文本指令生成 3D 模型，并导入到 Blender 中。
Blender 场景操控: 提供丰富的 Blender 场景操作工具，包括：
- 获取场景和对象信息
- 创建、修改和删除对象
- 设置对象材质
- 执行自定义 Python 代码，灵活扩展 Blender 功能
PolyHaven 资源集成: 无缝集成 PolyHaven 免费 3D 资源库，支持：
- 浏览和搜索 PolyHaven 的 HDRI、纹理和模型资源
- 下载 PolyHaven 资源并自动导入到 Blender 中
- 应用 PolyHaven 纹理到 Blender 对象
异步任务管理: 对于耗时的 3D 模型生成任务，采用异步处理模式，允许 AI 助手查询任务状态，实现高效的任务管理。

安装步骤

安装 Trellis Blender 插件:
- 从 https://github.com/FishWoWater/trellis_blender 下载 Trellis Blender 插件。
- 打开 Blender，进入 '编辑' -> '偏好设置' -> '插件' -> '安装'，选择下载的插件文件进行安装。
- 在 Blender 3D 视图侧边栏 'TRELLIS' 选项卡中，点击 'Start MCP Server' 启动 Blender 插件自带的 MCP 服务器。
配置 Trellis API 后端:
- 参考 https://github.com/FishWoWater/TRELLIS/blob/dev/README_api.md 部署 Trellis API 后端服务。（注意: Trellis 是开源的，需要用户自行部署 API 后端）
- 克隆 Trellis API 代码仓库：
```
git clone https://github.com/FishWoWater/TRELLIS
cd TRELLIS
```
- 编辑 'trellis_api/config.py' 文件，配置 API 后端 URL。
- 启动 Trellis API 服务 (根据 README 指引启动 ai_worker 和 web_server)。
配置 MCP 客户端:
- 在支持 MCP 协议的 AI 客户端（如 Windsurf, Cursor, Claude）中，配置 MCP 服务器连接信息。

服务器配置 (MCP 客户端配置)

以下 JSON 配置信息用于 MCP 客户端连接 Trellis Blender MCP Server。请将以下配置添加到您的 MCP 客户端配置中，例如 Windsurf/Cursor/Claude 的配置：

{
    "mcpServers": {
        "trellis-blender": {  // 服务器名称，可自定义
            "command": "uvx",  // 启动命令，固定为 "uvx"
            "args": [          // 命令参数
                "trellis-mcp"  // 参数，固定为 "trellis-mcp"
            ]
        }
    }
}

配置说明:

'"trellis-blender"': 服务器名称，您可以自定义，用于在 MCP 客户端中标识该服务器连接。
'"command": "uvx"': MCP 客户端启动服务器的命令，固定为 '"uvx"'，表示使用 UVX 运行时环境。
'"args": ["trellis-mcp"]': 传递给 UVX 运行时的参数，固定为 '["trellis-mcp"]'，用于指定启动 'trellis-mcp' 服务。

注意: 此配置假定 MCP 客户端已经安装了 'uvx' 运行时环境，并且 'trellis-mcp' 包已安装在 UVX 环境中。通常情况下，Blender 插件已经内置了 MCP 服务器的启动逻辑，用户只需在 Blender 插件中启动 MCP 服务器，然后在 MCP 客户端中配置上述连接信息即可。

基本使用方法

确保 Blender 软件已打开，并已安装 Trellis Blender 插件且成功启动 MCP Server。
在 AI 助手 (如 Claude, Cursor, Windsurf) 中配置并连接 "trellis-blender" MCP 服务器。
通过 AI 助手的自然语言交互界面，调用 MCP 服务器提供的工具，例如：
- 使用 'create_3d_model_from_text_trellis' 工具，根据文本提示生成 3D 模型。
- 使用 'search_polyhaven_assets' 和 'download_polyhaven_asset' 工具，浏览和导入 PolyHaven 资源。
- 使用 'create_object', 'modify_object', 'set_material' 等工具，操作 Blender 场景。
对于文本生成 3D 模型等异步任务，需要通过 'get_trellis_task_status' 工具轮询任务状态，并在任务完成后使用 'import_trellis_glb_model' 导入模型。

详细工具使用方法，请参考代码中每个 @mcp.tool 装饰器下方的函数注释 (docstring)。

关键词