GoModelHub 3D MCP

GoModelHub 3D 생성 API용 MCP 서버입니다. Cursor 및 기타 에이전트에서 자연어로 사용하세요.

Node.js 18+, 플랫폼 API 키(gk- / sk-), 그리고 Model Marketplace의 modelCode가 필요합니다 (예: hyper3d).

mcp.json에서 기본 모델을 한 번 설정하면 에이전트가 매번 model을 전달할 필요가 없습니다. 필요할 때 단일 호출에서 model을 재정의할 수도 있습니다.

중국어 문서

mcp.json의 기본 모델

키에 대해 Model Marketplace에 표시된 modelCode를 사용하세요 (tp- 접두사를 추가하지 마세요).

Related MCP server: Meshy MCP Server

옵션 1: Remote MCP (권장, 설치 불필요)

제한 사항: Remote MCP는 로컬 imagePath를 지원하지 않습니다. image-to-3D의 경우 공개 image URL을 사용하고, 로컬 이미지 파일의 경우 아래의 로컬 MCP를 사용하세요.

Cursor → 설정 → 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. 설치 (머신당 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를 참조하세요.