GoModelHub 3D MCP

MCP-сервер для API генерации 3D GoModelHub. Используйте его в Cursor и других агентах с помощью естественного языка.

Требуется Node.js 18+, ключ API платформы (gk- / sk-) и modelCode из Model Marketplace (например, hyper3d).

Установите модель по умолчанию один раз в mcp.json, чтобы агентам не нужно было передавать model каждый раз. Вы по-прежнему можете переопределить model в отдельном вызове при необходимости.

中文文档

Модель по умолчанию в mcp.json

Используйте modelCode, указанный в Model Marketplace для вашего ключа (не добавляйте префикс tp-).

Related MCP server: Meshy MCP Server

Вариант 1: Удаленный MCP (рекомендуется, без установки)

Ограничение: Удаленный MCP не поддерживает локальный imagePath. Для image-to-3D используйте публичный image URL; для локальных файлов изображений используйте локальный MCP ниже.

Cursor → Settings → MCP → отредактируйте mcp.json:

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

См. examples/mcp.remote.json.

Вариант 2: Локальный MCP (поддерживает imagePath)

1. Установка (один раз на машину)

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

Проверка: where gomodelhub-3d-mcp (Windows) или which gomodelhub-3d-mcp.

2. Настройка

{
  "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"
      }
    }
  }
}

См. examples/mcp.local.json. Сохраните и обновите в панели MCP.

3. Локальное изображение (image-to-3D)

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

Поддерживает jpg / png / webp, максимум 50MB на файл.

Сравнение

Устранение неполадок

Лицензия

MIT — см. LICENSE.