3d-eyes
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
3d-eyes 👁️
Give your coding agent eyes for 3D.
An MCP server that lets Claude Code (or any MCP client) see and diagnose 3D files - meshes and Gaussian splats - with zero GPU / OpenGL / Blender dependency. Pure numpy rendering: it runs on any machine, any container, any CI.
中文文档 · Agent Skill · Broken zoo
Your agent can write Three.js all day, but until now it debugged 3D files blind. Ask it "why is my model black?" and it guesses. With 3d-eyes it looks:

That's inspect_scene on a real broken file: six orthographic views plus
perspective, inward-facing triangles painted red, and a JSON report that
says exactly what's wrong:
{
"severity": "error",
"summary": "All face normals are inverted (negative enclosed volume).",
"symptom": "Model renders dark/black or shows red faces on every side.",
"fix": "Invert face winding: mesh.invert() in trimesh, or flip normals on export."
}The agent fixes the file, then proves it with diff_renders:

Gaussian splats too
3d-eyes speaks 3DGS: .ply (training output layout) and .splat. It renders
turntable previews and runs a quality report with density-adaptive floater
detection - the isolated blobs your training run left hanging in space:

"floaters": { "floater_count": 60, "floater_fraction": 0.0099,
"examples": [[3.4, -2.8, 3.1], ...] }Related MCP server: threejs-devtools-mcp
Quickstart
# Claude Code
claude mcp add 3d-eyes -- uvx 3d-eyes
# or from source
git clone https://github.com/murphy977/3d-eyes && cd 3d-eyes
pip install -e . && claude mcp add 3d-eyes -- 3d-eyesThen ask your agent things like:
"Check
assets/robot.glbbefore I ship it." "My model renders black in Three.js - here's the file." "Are there floaters inscene.splat?"
For best results, install the Agent Skill so your agent knows the symptom → cause table by heart:
mkdir -p ~/.claude/skills/3d-debugging && cp skill/SKILL.md ~/.claude/skills/3d-debugging/Tools
Tool | What it does |
| Contact sheet (6 ortho + perspective views) + structure stats + defect report. Red = faces seen from behind. Auto-detects splat files. |
| Custom angles: |
| Same-camera side-by-side of two files, plus both defect verdicts. Verify every fix. |
Detects: flipped/inconsistent normals · degenerate faces · non-manifold edges · missing texture/buffer references · scale unit mistakes (mm vs m) · splat floaters · nearly-transparent splat bloat. Corrupt files return a parse diagnosis instead of a crash.
Formats: GLB, GLTF, OBJ, PLY, STL (meshes) · 3DGS PLY, .splat (Gaussian splats).
Try it on the broken zoo
Every defect has a minimal sample file in examples/broken-zoo/:
3d-eyes inspect examples/broken-zoo/cube_flipped_normals.obj # all red + report
3d-eyes inspect examples/broken-zoo/torus_with_floaters.ply # 60 floaters found
3d-eyes diff examples/broken-zoo/cube_flipped_normals.obj fixed.obj(The CLI mirrors the MCP tools - handy for humans and CI pipelines.)
Why software rendering?
Agents run everywhere: laptops, devcontainers, CI runners, remote boxes. Any renderer that needs EGL/OSMesa/GPU drivers will eventually fail on one of them. 3d-eyes rasterizes with numpy + PIL - preview quality by design, 100% portability by design. An agent doesn't need path tracing to see that your normals are flipped.
Roadmap
.spzsplat formatTexture-mapped rendering
USD support
Animation / skeleton sanity checks
Optional pyrender backend for high-quality output
Screenshot-vs-render comparison for engine-side bug isolation
Issues and PRs welcome - the codebase is small and readable on purpose.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Blender and GLB/FBX/USD/STL rendered on cloud GPUs for AI agents: product shots, turntables, MP4
Parametric 3D CAD for AI agents: build print-ready parts, check them, export STL, 3MF or STEP.
Generate 3D models, worlds, PBR materials, and coordinated asset packs from AI agents.
3D avatar/asset foundry: text/image -> rigged, validated, engine-ready GLB via x402.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to create, edit, and export 3D models (GLB, USDZ) from natural-language descriptions and YAML, with rendering and problem detection.16 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to inspect and edit Three.js scenes, materials, shaders, lights, animations, and performance in real time, preview changes live in the browser, capture frames, and turn approved changes into code. It supports vanilla Three.js and React Three Fiber across WebGL/WebGPU without modifying the project.5,671 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to inspect and edit Three.js scenes, materials, shaders, lights, textures, animation, performance, and memory in real time, with live previews convertible into vanilla Three.js or React Three Fiber code. Also supports website audits, video frame capture, and Playwright/Puppeteer workflows.5,671 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to inspect, debug and edit Three.js scenes in real time from a live browser, covering objects, materials, shaders, textures, lights, animation, and performance. Live preview changes can be audited, reverted, or turned into ready-to-paste vanilla Three.js and React Three Fiber code without modifying the project.5,671 npmMIT