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.
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
- Python 3.10+
- Blender
- Trellis Blender Addon
- Trellis API Backend
- Claude / Cursor / Windsurf
Installation
1. Trellis blender addon
- Download Trellis Blender Addon from here
- Open Blender -> Edit -> Preferences -> Add-ons -> Install from file -> Select the downloaded addon -> Install
- 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
- Backbone and brain: Trellis
- Inspiration: blender-mcp
- Borrow a lot of code Tripo MCP Service
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)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| trellis_mcp-0.1.2.tar.gz | 16.2 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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.