trellis_blender

This MCP server is the Blender integration for TRELLIS and TRELLIS.2, enabling Blender users to drive 3D generation workflows directly from the MCP ecosystem. The addon exposes TRELLIS (text-to-3D, image-to-3D, and conditioned texture generation) and TRELLIS2 (text-to-3D and image-to-3D with the TRELLIS.2 backend) capabilities inside Blender, and can communicate with Cursor/Windsurf through the Trellis MCP bridge. To use it in MCP, start the server and configure the MCP client to point at the TRELLIS MCP endpoint so the MCP environment can orchestrate texture generation and mesh creation from text or images, then fetch results back into Blender.

After starting the MCP server, you can paste the configuration into Claude/Cursor/Windsurf to connect. The example configuration in the readme shows how to reference the MCP server by name and request execution via uvx (the Trellis MCP backend). Once connected, you can trigger TRELLIS/TRELLIS2 tasks (text-to-3D, image-conditioned 3D, and texture generation) and pull the resulting assets back into your Blender scene or export pipeline. The addon also supports switching between TRELLIS and TRELLIS.2 backends depending on your preferred path (native TRELLIS API server vs TRELLIS.2 server).

In practice, you’ll typically create a workflow that sends an object (or scene) and an optional input image to the API, configures generation parameters, and then downloads the resulting textured mesh back into Blender for further refinement or rendering.

• Prerequisites:

  • Blender 3.6.0 or higher
  • Access to TRELLIS and/or TRELLIS.2 API servers (either locally or hosted)

• Install prerequisites for MCP integration:

  1. Ensure you have an MCP-compatible environment where you can run the TRELLIS MCP bridge (as shown in the README example).
  2. If using TRELLIS.2, ensure you have the TRELLIS.2 API server accessible from your Blender host.

• Install the Blender addon:

  1. Download the plugin files from the repository (clone the repo).
  2. In Blender, go to Edit > Preferences > Add-ons.
  3. Click "Install" and select the trellis_for_blender.py file from the repository.
  4. Enable the addon by checking the box next to "3D View: TRELLIS".

• Start the MCP server integration:

  1. Run the TRELLIS MCP bridge (as configured in your MCP environment). For example, you can follow the example in the readme to start the uvx-based bridge:

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

  2. Ensure the MCP client (Claude/Cursor/Windsurf) can reach the server name you configured (trellis_blender in this setup).

• Connect from MCP client:

  • Open Claude/Cursor/Windsurf and paste the configuration snippet (adjust the server name if needed to match your setup):

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

  • Save and establish the connection. You can now send TRELLIS/TRELLIS.2 tasks from the MCP client to be executed by the Blender addon.

• The integration supports switching between TRELLIS and TRELLIS.2 backends; ensure your chosen backend is running and accessible.
• You can run both TRELLIS and TRELLIS.2 API servers in parallel and switch the backend in the Blender addon if needed.
• Typical generation parameters include Sparse Structure Settings, Structured Latent Settings, and Postprocessing Mesh Options. Fine-tune steps, CFG strength, texture size, and bake mode to balance quality and performance.
• If you encounter connectivity issues, verify network access between the Blender host and the TRELLIS MCP server, and ensure the server name in the MCP config matches what you’ve configured in the client.
• For troubleshooting, check the MCP bridge logs and Blender addon logs for error messages related to API requests, image/text payloads, or texture export steps.