C
cavi-ai/godot-mcp
Inspect GLB models in Godot, review materials and animation poses, and explore assets in an interactive 3D viewer.
★ 1·updated 2026-11-19
View on GitHub ↗Direct link · no redirect page
After install: how to tell it works
- What you see after install — The command exits 0 and the terminal shows no "command not found" or "permission denied".
- One-line self-check — Run the smallest usage example from that repository's README. If the output matches what the README describes, it is working.
- If that does not work — This project has no troubleshooting notes. Search its issues for "install".
The install command comes from the repository; these checks describe observable results only and do not replace the project's own docs.
- Star count
- 1 ★ · cavi-ai/godot-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-20 · last seen 2026-11-20 · seen 1× · listed by 3 sources
- Score
- score 303 · 1 ★ · 3 sources · repo
- Install
- see Install & config above
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
cavi-ai/godot-mcp;first catalogued 2026-11-20;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# Cavi Godot MCP
Excerpted from the repository README (abridged)
## Take it for a spin.
See your GLB as Godot imports it. Cavi Godot MCP helps your assistant inspect meshes, materials, skeletons and animation clips, then prepare a rendered view you can review together. Orbit a static asset or capture a selected animation pose without building a review scene by hand.
Try asking:
> Inspect my GLB in Godot. What meshes, materials and animation clips did it import? Prepare a three-quarter view so I can look it over.
## Set up
Native inspection and capture require macOS or Linux, Python 3.15 or newer, uv, a Godot editor and an existing workspace. Install the server:
sh
uv tool install cavi-godot-mcp
Configure your MCP client with the executable and the absolute workspace path:
json
"mcpServers": {
"godot": {
"command": "cavi-godot-mcp",
"env": {
"CAVI_GAME_ART_WORKSPACE": "/absolute/path/to/workspace"
Godot, Chromium and Node.js are found where they are installed: /Applications/Godot.app, /Applications/Google Chrome.app and /opt/homebrew/bin/node, then godot, chromium and node on PATH. Capture uses the single-threaded Web template (web_nothreads_release.zip) for the editor's version from Godot's export templates directory; install the export templates from the Godot editor. Capture needs Chromium with WebGL 2 support and Node.js 22 or newer.
To use other files, set CAVI_GODOT_BIN, CAVI_GODOT_WEB_TEMPLATE, CAVI_CHROMIUM_BIN or CAVI_NODE_BIN to an absolute path. A set variable always wins: when its file is missing, that tool is reported as not found. godot_status reports which tools are found.
## Review your asset
Inspect a self-contained GLB for scene nodes, mesh surfaces, materials, UV presence, skeletons and clips.
Sample an animation's node and skeleton transforms at selected times.
Prepare and capture a static view, including texture-free and vertex-colored drafts before cleanup, or capture one selected pose from an animated GLB. Open the capture for visual review.
Serve the exported review bundle locally to orbit and zoom; press R to reset the camera. A white bar on the asset's bottom front edge is the largest power of ten that fits it, such as 1 cm or 1 m, and the label names its length. Pose reviews open paused at the requested time. Play or pause the selected clip, scrub the timeline, or select Reset pose.
Operations, limits and recovery
godot_asset_inspect takes a workspace-relative source and a new workspace-relative directory. It accepts self-contained GLB 2.0 files up to 64 MiB. Its mesh bounds describe the imported rest pose; reports include totals and truncation flags for capped records. Inspection uses Godot's headless runtime importer and does not require a browser or Web template.
For motion, use the inspection report's player path and clip name with godot_motion_inspect. Supply 2–9 strictly increasing normalized_times between 0 and 1. The result measures node and skeleton transforms, not skinned surface deformation.
For a static review, godot_review_prepare takes the source, a new directory and front, three-quarter or side view. The three-quarter view is 45° between front and side, and the camera distance fits the asset's bounding sphere to the 45° field of view at any size. Static inputs cannot contain skins or animations. Textures are optional; any images must be embedded PNG or JPEG. Geometry-only static triangles without normals or materials use neutral shading for review. To review an animated asset, inspect it first and provide a selected pose with the reported player path, animation name and time in seconds. A pose review frames the skinned meshes as deformed at that time. For matched comparisons, capture the larger asset first, then pass its returned scene.camera_frame as framing for the other asset at the same view. For static reviews, set all_views to capture all three angles in one session; the selected view remains capture.png, and the other angles use capture-front.png, capture-three-quarter.png or capture-side.png. godot_review_capture produces the frames, and godot_review_inspect checks source, tool and artifact hashes and reports the latest attempt. Captures light the asset with a neutral grey sky that metals reflect and use AgX tonemapping; scene.renderer records Godot's rendering method, driver and adapter.
See your GLB as Godot imports it. Cavi Godot MCP helps your assistant inspect meshes, materials, skeletons and animation clips, then prepare a rendered view you can review together. Orbit a static asset or capture a selected animation pose without building a review scene by hand.
Try asking:
> Inspect my GLB in Godot. What meshes, materials and animation clips did it import? Prepare a three-quarter view so I can look it over.
## Set up
Native inspection and capture require macOS or Linux, Python 3.15 or newer, uv, a Godot editor and an existing workspace. Install the server:
sh
uv tool install cavi-godot-mcp
Configure your MCP client with the executable and the absolute workspace path:
json
"mcpServers": {
"godot": {
"command": "cavi-godot-mcp",
"env": {
"CAVI_GAME_ART_WORKSPACE": "/absolute/path/to/workspace"
Godot, Chromium and Node.js are found where they are installed: /Applications/Godot.app, /Applications/Google Chrome.app and /opt/homebrew/bin/node, then godot, chromium and node on PATH. Capture uses the single-threaded Web template (web_nothreads_release.zip) for the editor's version from Godot's export templates directory; install the export templates from the Godot editor. Capture needs Chromium with WebGL 2 support and Node.js 22 or newer.
To use other files, set CAVI_GODOT_BIN, CAVI_GODOT_WEB_TEMPLATE, CAVI_CHROMIUM_BIN or CAVI_NODE_BIN to an absolute path. A set variable always wins: when its file is missing, that tool is reported as not found. godot_status reports which tools are found.
## Review your asset
Inspect a self-contained GLB for scene nodes, mesh surfaces, materials, UV presence, skeletons and clips.
Sample an animation's node and skeleton transforms at selected times.
Prepare and capture a static view, including texture-free and vertex-colored drafts before cleanup, or capture one selected pose from an animated GLB. Open the capture for visual review.
Serve the exported review bundle locally to orbit and zoom; press R to reset the camera. A white bar on the asset's bottom front edge is the largest power of ten that fits it, such as 1 cm or 1 m, and the label names its length. Pose reviews open paused at the requested time. Play or pause the selected clip, scrub the timeline, or select Reset pose.
Operations, limits and recovery
godot_asset_inspect takes a workspace-relative source and a new workspace-relative directory. It accepts self-contained GLB 2.0 files up to 64 MiB. Its mesh bounds describe the imported rest pose; reports include totals and truncation flags for capped records. Inspection uses Godot's headless runtime importer and does not require a browser or Web template.
For motion, use the inspection report's player path and clip name with godot_motion_inspect. Supply 2–9 strictly increasing normalized_times between 0 and 1. The result measures node and skeleton transforms, not skinned surface deformation.
For a static review, godot_review_prepare takes the source, a new directory and front, three-quarter or side view. The three-quarter view is 45° between front and side, and the camera distance fits the asset's bounding sphere to the 45° field of view at any size. Static inputs cannot contain skins or animations. Textures are optional; any images must be embedded PNG or JPEG. Geometry-only static triangles without normals or materials use neutral shading for review. To review an animated asset, inspect it first and provide a selected pose with the reported player path, animation name and time in seconds. A pose review frames the skinned meshes as deformed at that time. For matched comparisons, capture the larger asset first, then pass its returned scene.camera_frame as framing for the other asset at the same view. For static reviews, set all_views to capture all three angles in one session; the selected view remains capture.png, and the other angles use capture-front.png, capture-three-quarter.png or capture-side.png. godot_review_capture produces the frames, and godot_review_inspect checks source, tool and artifact hashes and reports the latest attempt. Captures light the asset with a neutral grey sky that metals reflect and use AgX tonemapping; scene.renderer records Godot's rendering method, driver and adapter.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/cavi-ai-godot-mcp/)
- Source
- github · https://github.com/cavi-ai/godot-mcp
- Browse by field
- Open source
- Traction
- 1 ★
- Listed by
- 3 independent sources
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.