Mcp Server 3daistudio

io.github.whale-professorPublished by GitHub account whale-professorv1.0.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyMedia & DesignAI & ML

Overview

AI-generated overview

Local MCP server that lets an assistant turn text prompts or images into 3D models through the 3D AI Studio API, saving them as GLB files.

What you can do
  • Generate 3D models from a text prompt using Hunyuan Rapid or Hunyuan Pro
  • Convert a single image into a 3D model with TRELLIS.2
  • Write the resulting model to a file such as a GLB
  • Check the remaining credit balance on the 3D AI Studio account
When to use it
Useful when you want an assistant to produce 3D assets from descriptions or reference images without leaving the chat, for example props, characters or product mockups, and you already have a 3D AI Studio account.
Requirements
Runs as a local Python process (PyPI package mcp-server-3daistudio, stdio transport). Needs a 3D AI Studio API key supplied in the THREE_D_AI_STUDIO_API_KEY environment variable, plus network access to the 3D AI Studio API. Desktop only.
Before you install
Generation consumes paid credits on the 3D AI Studio account (roughly 15 to 100 per model depending on model), so repeated runs cost money; check the balance first. The API key is a secret and should not be shared. Prompts and images are sent to the third-party 3D AI Studio service.

Installation

In SourceWeft

  1. Open Mcp Server 3daistudio in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

  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

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

Quick Start

bash
# Check balancepython 3daistudio.py balance
# Image to 3D with TRELLIS.2python 3daistudio.py trellis --image photo.png -o model.glb
# Text to 3D with Hunyuan Rapidpython 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

Source: README.md at commit bc97adc

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts