io.github.whale-professor/mcp-server-3daistudio
MCP server for 3D AI Studio — generate 3D models from text or images using Hunyuan and TRELLIS
Open source Open in the app JSON README (API)
About
MCP server for 3D AI Studio — generate 3D models from text or images using Hunyuan and TRELLIS
Details
- Kind
- MCP servers
- Topic
- Media, design & games
- Publisher
- whale-professor
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Stars
- 2
- Forks
- 1
- Last push
- 2026-04-26T20:45:38Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 04:01:39
- Updated
- 2026-08-29 04:01:39
- Origin id
io.github.whale-professor/mcp-server-3daistudio
README
# 3D AI Studio Skill A skill for converting images and text prompts to 3D models using the [3D AI Studio API](https://www.3daistudio.com). ## Owner Whale Professor (@WhaleProfessor on Telegram) ## Setup 1. Get an API key from https://www.3daistudio.com/Platform/API 2. Set the environment variable: ```bash export THREE_D_AI_STUDIO_API_KEY="your-api-key" ``` Or copy `.env.example` to `.env` and fill in your key. 3. Run the skill: ```bash python 3daistudio.py balance ``` ## Supported Models | Model | Input | Speed | Credits | |-------|-------|-------|---------| | **TRELLIS.2** | Image only | 25s–4min | 15–55 | | **Hunyuan Rapid** | Text or image | 2–3min | 35–55 | | **Hunyuan Pro** | Text or image | 3–6min | 60–100 | ## Quick Start ```bash # Check balance python 3daistudio.py balance # Image to 3D with TRELLIS.2 python 3daistudio.py trellis --image photo.png -o model.glb # Text to 3D with Hunyuan Rapid python 3daistudio.py rapid --prompt "a wooden chair" -o chair.glb # Text to 3D with Hunyuan Pro (best quality) python 3daistudio.py pro --prompt "a cute blue hedgehog" -o hedgehog.glb ``` ## MCP Server An MCP server is also included for use with Claude Desktop or Claude Code. See [`mcp-server-3daistudio/`](mcp-server-3daistudio/) for the installable package, or use `mcp_server.py` directly as a standalone server. ## Documentation - [GUIDE.md](GUIDE.md) — Full usage guide with all options and examples - [SKILL.md](SKILL.md) — Skill metadata and quick reference - [CLAUDE.md](CLAUDE.md) — Instructions for AI agents ## License MIT