Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
HY3D_PYNoPython interpreter with the worker packages (opencv-python, numpy, trimesh, pillow, scipy) installed.~/git/repos/trellis-mac/.venv/bin/python
HY3D_OUTNoDirectory where generated 3D models are written.~/hy3d-output
HY3D_REPONoPath to the Hunyuan3D-MLX repository checkout.~/git/repos/hunyuan3d-mlx

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
generate_modelA

Turn a concept image into a textured 3D model (GLB).

paint=False skips texturing (shape only, ~20s vs ~3-4 min). auto_cutout keys out a plain background first unless the input already carries real transparency. finish=True applies the game-look texture pass (see finish_model) after generation. texture_size: 512|1024|2048. Blocks while an earlier generation is running (single-job queue).

prepare_conceptA

Key a plain-background concept image out to a centered square RGBA PNG.

Standalone version of generate_model's auto_cutout, for callers that want the intermediate. Refuses inputs whose corners disagree (busy background). Warns when the opaque fraction looks like a bad key.

finish_modelA

Apply the game-look texture pass to a generated GLB. Geometry untouched.

Tones the albedo (gamma/contrast/saturation), extracts saturated accents and blackhat panel seams into a dedicated glTF emissive texture. Separated from generation so it can be re-run with new knobs without regenerating. seam_pinstripes 0-1 (0 disables); defaults are the values proven on the AEGIS fleet.

render_previewA

Offscreen renders of a GLB, no engine needed.

views: subset of iso/front/back/top/side (default [iso]). Needs pyrender in the worker venv; the error message says how to add it if missing.

server_statusA

Health check and first-run diagnostic.

Validates every setup requirement (binary, metallib, weights, weight layout, worker venv); each failing check carries the exact fix. Also reports queue depth and the last job.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JimCline/hy3d-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server