GoModelHub 3D MCP

用于 GoModelHub 3D 生成 API 的 MCP 服务器。可在 Cursor 和其他 Agent 中使用自然语言调用。

需要 Node.js 18+、平台 API Key（gk- / sk-）以及来自 Model Marketplace 的 modelCode（例如 hyper3d）。

在 mcp.json 中一次性设置默认模型，这样 Agent 无需每次都传递 model。需要时仍可在单次调用中覆盖 model。

中文文档

在 mcp.json 中设置默认模型

请使用 Model Marketplace 中为你的 Key 显示的 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. 安装（每台机器一次）

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，单文件最大 50MB。

对比

故障排除

许可证

MIT — 参见 LICENSE。