# glbforge

Validates 3D mesh geometry, optimizes models against strict polygon budgets, and tracks edits with structural diffs inside agent workflows.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: glbforge
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/glbforge/glbforge
- Updated: 2026-10-01
- HTML: https://affpapa.org/en/nevibecode/mcp/glbforge

## What it does

The `@glbforge/mcp` server equips coding agents with 28 specialized 3D tools. Its `inspect` routine parses mesh topology, reports holes, and verifies scale within tens of milliseconds. The `diff` tool lets an agent catch geometry regressions between edits, tracking polygon changes and comparing camera angles with SSIM visual checks.

Vector graphics bypass generative models entirely. The server traces silhouettes into clean 3D meshes of roughly 1.5k triangles. Photographed objects can be separated from backgrounds with the automatic matte filter or routed to an external generator.

Running generative tasks requires setting the `MESHY_API_KEY` variable. Without this token, requests relying on the Meshy API fail, though local analysis and mesh reduction continue to operate.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MESHY_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add glbforge -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add glbforge --env MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "glbforge": {
            "command": "npx",
            "args": [
                "-y",
                "@glbforge/mcp"
            ],
            "env": {
                "MESHY_API_KEY": "<MESHY_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "glbforge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@glbforge/mcp"
            ],
            "env": {
                "MESHY_API_KEY": "<MESHY_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MESHY_API_KEY=<MESHY_API_KEY> glbforge npx -y @glbforge/mcp
```
Replace <…> with your own values

## When to use it
- check 3D meshes for unclosed boundaries and holes
- compare mesh revisions with SSIM and triangle counts
- extrude vector silhouettes into clean 3D assets
- reduce polycount to meet web performance budgets

## Example prompts
- Inspect `robot.glb` with glbforge and list any topology defects
- Run a diff between `model_v1.glb` and `model_v2.glb` to check for regressions
- Extrude `badge.png` into a watertight GLB model

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25137
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4534
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1349
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1218
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 982
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 732

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md