glbforge — Claude Code MCP server: what it does, how to install
Validates 3D mesh geometry, optimizes models against strict polygon budgets, and tracks edits with structural diffs inside agent workflows.
claude mcp add glbforge -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcpWhat glbforge 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.
What it helps with
- 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 for the agent
- Inspect
robot.glbwith glbforge and list any topology defects - Run a diff between
model_v1.glbandmodel_v2.glbto check for regressions - Extrude
badge.pnginto a watertight GLB model
How to install glbforge
Platform CLI
claude mcp add glbforge -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcpReplace <…> with your own values
Platform CLI
codex mcp add glbforge --env MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"glbforge": {
"command": "npx",
"args": [
"-y",
"@glbforge/mcp"
],
"env": {
"MESHY_API_KEY": "<MESHY_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"glbforge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@glbforge/mcp"
],
"env": {
"MESHY_API_KEY": "<MESHY_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MESHY_API_KEY=<MESHY_API_KEY> glbforge npx -y @glbforge/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about glbforge
How do I install glbforge in Claude Code?
Run claude mcp add glbforge -e MESHY_API_KEY=<MESHY_API_KEY> -- npx -y @glbforge/mcp. Replace <MESHY_API_KEY> with your active Meshy key if you plan to generate assets from prompts or images.
What does glbforge do?
It provides inspection tools that let coding agents read 3D mesh topology, spot structural bugs after edits, and enforce size budgets before assets go to production.
Does 2D logo extrusion require an AI model?
No, the extrusion tool relies purely on silhouette tracing and computational geometry. It creates a watertight asset of around 1.5k triangles without using generative models or API tokens.
