English Français العربية

io.github.whale-professor/mcp-server-3daistudio

Official registry Media and design

MCP server for 3D AI Studio — generate 3D models from text or images using Hunyuan and TRELLIS

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-server-3daistudio
Claude Code 
claude mcp add mcp-server-3daistudio -e 'THREE_D_AI_STUDIO_API_KEY=<your three_d_ai_studio_api_key>' -- uvx mcp-server-3daistudio==1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-server-3daistudio": {
            "command": "uvx",
            "args": [
                "mcp-server-3daistudio==1.0.1"
            ],
            "env": {
                "THREE_D_AI_STUDIO_API_KEY": "<your three_d_ai_studio_api_key>"
            }
        }
    }
}

Environment variables

  • THREE_D_AI_STUDIO_API_KEY required secret API key for 3D AI Studio

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. 3D AI Studio Skill
  2. Owner
  3. Setup
  4. Supported Models
  5. Quick Start
  6. MCP Server
  7. Documentation
  8. License

3D AI Studio Skill

A skill for converting images and text prompts to 3D models using the 3D AI Studio API.

Owner

Whale Professor (@WhaleProfessor on Telegram)

Setup

  1. Get an API key from https://www.3daistudio.com/Platform/API

  2. Set the environment variable:

     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:
     python 3daistudio.py balance

Supported Models

ModelInputSpeedCredits
TRELLIS.2Image only25s–4min15–55
Hunyuan RapidText or image2–3min35–55
Hunyuan ProText or image3–6min60–100

Quick Start

# 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/ for the installable package, or use mcp_server.py directly as a standalone server.

Documentation

  • GUIDE.md — Full usage guide with all options and examples
  • SKILL.md — Skill metadata and quick reference
  • CLAUDE.md — Instructions for AI agents

License

MIT

Frequently asked questions

What is io.github.whale-professor/mcp-server-3daistudio?

MCP server for 3D AI Studio — generate 3D models from text or images using Hunyuan and TRELLIS

How do I install io.github.whale-professor/mcp-server-3daistudio?

It runs on your machine. In Claude Code: claude mcp add mcp-server-3daistudio -e 'THREE_D_AI_STUDIO_API_KEY=<your three_d_ai_studio_api_key>' -- uvx mcp-server-3daistudio==1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.whale-professor/mcp-server-3daistudio need an API key?

Yes. It expects THREE_D_AI_STUDIO_API_KEY, which you set in its configuration.

Is io.github.whale-professor/mcp-server-3daistudio open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.whale-professor/mcp-server-3daistudio?

It is published by whale-professor. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.