GoModelHub 3D MCP

Servidor MCP para la API de generación 3D de GoModelHub. Úsalo en Cursor y otros Agents con lenguaje natural.

Requiere Node.js 18+, una API Key de la plataforma (gk- / sk-) y un modelCode de Model Marketplace (p. ej. hyper3d).

Configura tu modelo predeterminado una vez en mcp.json para que los Agents no tengan que pasar model cada vez. Aún puedes sobrescribir model en una llamada individual cuando sea necesario.

中文文档

Modelo predeterminado en mcp.json

Usa el modelCode que se muestra en Model Marketplace para tu Key (no añadas un prefijo tp-).

Related MCP server: Meshy MCP Server

Opción 1: MCP remoto (recomendado, sin instalación)

Limitación: el MCP remoto no admite imagePath local. Para image-to-3D, usa una URL image pública; para archivos de imagen locales, usa el MCP local que aparece a continuación.

Cursor → Configuración → MCP → edita mcp.json:

{
  "mcpServers": {
    "gomodelhub-3d": {
      "url": "https://login.gomodelhub.com/mcp/3d",
      "headers": {
        "Authorization": "Bearer gk-your-platform-key",
        "X-GoModelHub-Default-Model": "hyper3d"
      }
    }
  }
}

Consulta examples/mcp.remote.json.

Opción 2: MCP local (admite imagePath)

1. Instalación (una vez por máquina)

git clone https://github.com/kelouer/GoModelHub-MCP.git
cd GoModelHub-MCP
npm install
npm install -g .

Windows: powershell -ExecutionPolicy Bypass -File scripts/install-global.ps1
macOS/Linux: bash scripts/install-global.sh

Verifica: where gomodelhub-3d-mcp (Windows) o which gomodelhub-3d-mcp.

2. Configuración

{
  "mcpServers": {
    "gomodelhub-3d": {
      "command": "gomodelhub-3d-mcp",
      "env": {
        "GOMODELHUB_BASE_URL": "https://login.gomodelhub.com",
        "GOMODELHUB_API_KEY": "gk-your-platform-key",
        "GOMODELHUB_DEFAULT_MODEL": "hyper3d"
      }
    }
  }
}

Consulta examples/mcp.local.json. Guarda y Actualiza en el panel de MCP.

3. Imagen local (image-to-3D)

{
  "model": "v3.1-20260211",
  "imagePath": "D:/photos/chair.jpg",
  "mode": "image"
}

Admite jpg / png / webp, máx. 50MB por archivo.

Comparación

Solución de problemas

Licencia

MIT — consulta LICENSE.