Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@GoModelHub 3D MCP generate a 3D model of a wooden chair"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for the GoModelHub 3D generation API — use it in Cursor and other AI Agents with natural language.
English · 中文文檔 · 日本語 · Deutsch · Report Bug · Deploy Guide
Zero-config Remote MCP — Streamable HTTP, no local install needed
Local stdio MCP — supports local imagePath for image-to-3D
3 Tools — generate_3d, get_3d_status, generate_3d_and_wait
Cross-platform — Windows / macOS / Linux
Related MCP server: Meshy MCP Server
Tool | Description |
| Submit a 3D job; returns |
| Poll task status |
| Submit and poll until done (recommended) |
Node.js 18+
Platform API Key (gk- / sk-) — get it from GoModelHub
modelCode from Model Marketplace (e.g. hyper3d)
Mode | Where | Example |
Remote MCP |
|
|
Local MCP |
|
|
Use the modelCode shown in Model Marketplace (no tp- prefix).
Remote MCP does not support local
imagePath. Use a publicimageURL for image-to-3D.
{
"mcpServers": {
"gomodelhub-3d": {
"url": "https://login.gomodelhub.com/mcp/3d",
"headers": {
"Authorization": "Bearer gk-your-key",
"X-GoModelHub-Default-Model": "hyper3d"
}
}
}
}git clone https://github.com/kelouer/GoModelHub-MCP.git
cd GoModelHub-MCP
npm install
npm install -g .OS | Command |
Windows |
|
macOS / Linux |
|
Verify: where gomodelhub-3d-mcp (Windows) or which gomodelhub-3d-mcp.
{
"mcpServers": {
"gomodelhub-3d": {
"command": "gomodelhub-3d-mcp",
"env": {
"GOMODELHUB_BASE_URL": "https://login.gomodelhub.com",
"GOMODELHUB_API_KEY": "gk-your-key",
"GOMODELHUB_DEFAULT_MODEL": "hyper3d"
}
}
}
}See examples/mcp.local.json. Save and Refresh.
{ "model": "v3.1-20260211", "imagePath": "D:/photos/chair.jpg", "mode": "image" }Supports jpg / png / webp, max 50MB.
Remote MCP | Local MCP | |
Install | None |
|
Text-to-3D | ✅ | ✅ |
Public | ✅ | ✅ |
Local | ❌ | ✅ |
Symptom | Fix |
| Ensure |
| Check |
| Set default model or pass |
HTTP 401 / 403 | Invalid key or insufficient quota |
Remote image-to-3D fails | Use public |
MIT — see LICENSE.
Submit a 3D generation job to GoModelHub. Supports text/URL (JSON) or local image file (multipart). Returns taskId.
Inputs: mode, image, model, prompt, +2 more.
Submit a 3D job (JSON or local image) and poll until succeeded/failed or timeout.
Inputs: mode, image, model, prompt, +4 more.
Poll 3D task status once. When status=succeeded, download via assetUrl with the same API key.
Inputs: taskId (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 3 tools
The three tools are mostly distinct: get_3d_status only polls, generate_3d submits async, and generate_3d_and_wait submits plus polls. However, generate_3d and generate_3d_and_wait share a similar starting action, which could cause minor confusion despite the names making the difference clear.
All tool names use snake_case with a verb-first pattern: get_3d_status, generate_3d, generate_3d_and_wait. The naming is consistent in style, though generate_3d_and_wait is slightly more compound and less uniform than the other two.
Three tools is a well-scoped set for a 3D generation MCP: one async submit, one sync submit-and-wait, and one status poller. Each tool serves a clear purpose without unnecessary bloat.
The tool surface covers the core 3D generation workflow: submitting a job, polling status, and knowing when to download via assetUrl. It lacks explicit cancellation or result-download tools, but those may be outside the intended scope and are not critical gaps.
Generate 3D models from images or text with AI, then retexture or convert them to STL, 3MF or OBJ.
Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Free text/image → 3D: generate, rig, avatar-ify, and refine GLB models. No auth, no payment.
Turn a photo, drawing or text description into a textured 3D model (GLB, FBX, OBJ, USDZ, STL).
