maya_vision3d
Generate 3D assets from images or text prompts via a GPU-powered Vision3D server. Start jobs, poll progress, and download results.
Instructions
AI-powered 3D asset generation via Vision3D server (requires GPU with Hunyuan3D-2).
Server selection is fully per-session and runtime-only: the first
action that needs a GPU call returns vision3d_url_required. The
LLM must ask the user for the Vision3D URL in the chat and then call
select_server with that URL. Nothing is persisted to disk — the
URL lives only in process memory until the MCP server restarts.
After selection, jobs are non-blocking: start → poll → download.
Available actions:
• select_server — Set the Vision3D server URL for the rest of the session. Required params: {"url": "http://..."}. Accepts any valid http/https URL; ask the user first. • health — Check if the selected Vision3D server is running and what GPU/models are available. No params. • generate_image — Start 3D generation from a reference image. Required params: {"image_path": "/path/to/image.png", "output_subdir": "my_asset"} Optional: {"preset": "medium", "model": "turbo", "octree_resolution": 384, "num_inference_steps": 20, "target_faces": 50000} • generate_text — Start 3D generation from a text prompt. Required params: {"text_prompt": "a medieval sword", "output_subdir": "sword"} Optional: {"preset": "medium", "model": "turbo", "octree_resolution": 384, "num_inference_steps": 20, "target_faces": 50000} • texture — Texture an existing mesh using a reference image. Required params: {"output_subdir": "my_asset"} Optional: {"mesh_filename": "mesh.glb", "image_filename": "input.png"} • poll — Check job progress (call repeatedly while running). Required params: {"job_id": "uuid-from-generate"} • download — Download completed job results. Required params: {"job_id": "uuid", "output_subdir": "my_asset"} Optional: {"files": ["textured.glb", "mesh.glb"]}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |