hy3d-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HY3D_PY | No | Python interpreter with the worker packages (opencv-python, numpy, trimesh, pillow, scipy) installed. | ~/git/repos/trellis-mac/.venv/bin/python |
| HY3D_OUT | No | Directory where generated 3D models are written. | ~/hy3d-output |
| HY3D_REPO | No | Path to the Hunyuan3D-MLX repository checkout. | ~/git/repos/hunyuan3d-mlx |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| 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
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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