Content
# Trellis MCP Server
Trellis MCP provides an interface between AI assistants and [Trellis](https://github.com/microsoft/TRELLIS) via [Model Context Protocol (MCP)](https://modelcontextprotocol.io).
### Disclaimer
This project shows a very **minimal** integration of MCP with [Trellis](https://github.com/microsoft/TRELLIS): a lightweight and opensource text-to-3d/image-to-3d 3DAIGC model. Compared with existing [rodin integration in blender-mcp](https://github.com/ahujasid/blender-mcp) and [tripo integration](https://github.com/VAST-AI-Research/tripo-mcp), 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](https://github.com/FishWoWater/TRELLIS/blob/dev/README_api.md)).
* 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
- [x] 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](https://www.blender.org/download/)
- [Trellis Blender Addon](https://github.com/FishWoWater/trellis_blender)
- [Trellis API Backend](https://github.com/FishWoWater/TRELLIS)
- Claude / Cursor(SUGGESTED) / Windsurf
### Installation
#### 1. Trellis blender addon
1. Download Trellis Blender Addon from [here](https://github.com/FishWoWater/trellis_blender)
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](https://github.com/FishWoWater/TRELLIS/blob/dev/README_api.md)
``` shell
# 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
# no need for image workers
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
# or on windows local dev
python trellis_api/web_server_single.py
```
#### 3. Configure the MCP server on Windsurf/Cursor/Claude
```text
{
"mcpServers": {
"trellis-blender": {
"command": "uvx",
"args": [
"trellis-mcp"
]
}
}
}
```
## Acknowledgements
- Backbone and brain: [Trellis](https://github.com/microsoft/TRELLIS)
- Inspiration: [blender-mcp](https://github.com/ahujasid/blender-mcp)
- Borrow a lot of code [Tripo MCP Service](https://github.com/VAST-AI-Research/tripo-mcp)
Connection Info
You Might Also Like
semantic-kernel
Integrate cutting-edge LLM technology quickly and easily into your apps
repomix
📦 Repomix is a powerful tool that packs your entire repository into a...
Serena
A powerful coding agent toolkit providing semantic retrieval and editing...
Blender
BlenderMCP integrates Blender with Claude AI for enhanced 3D modeling.
pydantic-ai
GenAI Agent Framework, the Pydantic way
cua
Open-source infrastructure for Computer-Use Agents. Sandboxes, SDKs, and...