Skip to main content

Trellis MCP Server

Trellis MCP provides an interface between AI assistants and Trellis via Model Context Protocol (MCP).

Disclaimer

This project shows a very minimal integration of MCP with Trellis: a lightweight and opensource text-to-3d/image-to-3d 3DAIGC model. Compared with existing rodin integration in blender-mcp and tripo integration, it has following advantages:

  • Faster and memory-efficient: You can deploy TRELLIS locally with only 8GPU+ VRAM, while can generate a textured mesh from text in only ~15s(10s with more vram).
  • FREE: You DON'T have to pay expensive API from Rodin/Meshy/Tripo.

BUT IT HAS FOLLOWING LIMITATIONS:

  • Trellis is open-source and there is no off-the-shelf API model providers, you have to deploy it by yourself (refer to README).
  • The API/Prompt has NOT been fully tested/tuned, may suffer from stability issues.

So use it at your own risk.

Demo

A minimal demo for generating a single object, more complicated prompt with blender-mcp is under tuning.

Demo

Features

  • Generate 3D asset from natural language(TEXT) using Trellis API and import into blender
  • Generate texture/materials from natural language(TEXT) for a given 3D mesh using Trellis API and import into blender

Roadmap

Prerequisites

Installation

1. Trellis blender addon

  1. Download Trellis Blender Addon from here
  2. Open Blender -> Edit -> Preferences -> Add-ons -> Install from file -> Select the downloaded addon -> Install
  3. In 3D Viewport -> View3D > Sidebar > TRELLIS -> Start MCP Server

2. Configure API backend

As trellis is a free open-source text-to-3d model, you need to deploy your own trellis API backend with reference to README

# clone an API fork of trellis 
git clone https://github.com/FishWoWater/TRELLIS
cd TRELLIS

# EDIT BACKEND URL in trellis_api/config.py

# configure the # of text workers and start ai worker
python trellis_api/ai_worker.py --text-workers-per-gpu 1 --image-workers-per-gpu 0

# start web server 
python trellis_api/web_server.py 

3. Configure the MCP server on Windsurf/Cursor/Claude

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

Acknowledgements

Metadata

Release files for trellis-mcp 0.1.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for trellis-mcp 0.1.2
File Size Uploaded Provenance
trellis_mcp-0.1.2.tar.gz 16.2 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for trellis-mcp 0.1.2
File Interpreter ABI Platform
trellis_mcp-0.1.2-py3-none-any.whl Python 3 none any Details

Total release size: 31.8 kB

Release files / trellis_mcp-0.1.2.tar.gz

Download URL trellis_mcp-0.1.2.tar.gz
Size 16.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d64dc7370f3e02a9ac683dfd9b8bf2f3cba5bc0e052d7697b4a54712ff861f95
BLAKE2b-256 checksum
How to use checksums
55d6c64771dbef0005af493ac3ba5be4d0080b0ad386a603c96902cec7d36095
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.10

Release files / trellis_mcp-0.1.2-py3-none-any.whl

Download URL trellis_mcp-0.1.2-py3-none-any.whl
Size 15.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6361921b256194bc297640a90daadb4a3f12163aba0c20d9c8e212851751cb5d
BLAKE2b-256 checksum
How to use checksums
60923972054fc63d5182fbb8a6ee5053811e7c54fb5b8315ccb74eddfa1eeb3a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.6.10

Security for trellis-mcp 0.1.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.2 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page