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: リモートMCP（推奨、インストール不要）

制限事項: リモートMCPはローカルのimagePathをサポートしていません。画像から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. インストール（マシンごとに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. ローカル画像（画像から3Dへ）

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

jpg / png / webpに対応、1ファイルあたり最大50MB。

比較

トラブルシューティング

ライセンス

MIT — LICENSEを参照してください。