mcp-server-3daistudio

Name: mcp-server-3daistudio
Author: whale-professor

Local

github.com/whale-professorMedia & Design3Updated 26w ago

Repository

About mcp-server-3daistudio

mcp-server-3daistudio is a Python skill and MCP server for generating 3D models from text prompts or images through the 3D AI Studio API. It supports TRELLIS.2 for images and Hunyuan Rapid and Pro for text or image inputs.

Key features

01Generate 3D models from images
02Generate 3D models from text prompts
03Use TRELLIS.2 and Hunyuan models
04Check API credit balance
05Save generated models as GLB

Use cases

01Turn a photo into a 3D model
02Create a model from a text description
03Check API balance before generating

MCP support

The project includes an MCP server for use with Claude Desktop or Claude Code. It makes the 3D AI Studio model-generation capability available through MCP.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "whale-professor-mcp-server-3daistudio": {
      "command": "uvx",
      "args": [
        "mcp-server-3daistudio"
      ],
      "env": {
        "THREE_D_AI_STUDIO_API_KEY": "<THREE_D_AI_STUDIO_API_KEY>"
      }
    }
  }
}

Run commanduvx mcp-server-3daistudio

Environment variables to set

THREE_D_AI_STUDIO_API_KEYSecretAPI key for 3D AI Studio

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

pypimcp-server-3daistudio1.0.1stdio

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Get an API key from https://www.3daistudio.com/Platform/API
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.
Run the skill:
```
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

# 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.