Cavi Godot MCP
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:
uv tool install cavi-godot-mcp
Configure your MCP client with the executable and absolute paths. Inspection needs only the workspace and Godot paths:
{
"mcpServers": {
"godot": {
"command": "cavi-godot-mcp",
"env": {
"CAVI_GAME_ART_WORKSPACE": "/absolute/path/to/workspace",
"CAVI_GODOT_BIN": "/absolute/path/to/godot"
}
}
}
}
To capture a rendered view, also set CAVI_GODOT_WEB_TEMPLATE, CAVI_CHROMIUM_BIN and CAVI_NODE_BIN to absolute paths. Use a single-threaded Web export template matching your Godot editor, headless Chromium with WebGL 2 support, and Node.js 22 or newer.
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, 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 a static asset; press R to reset. A white bar marks one metre.
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. Static inputs cannot contain skins or animations; textures must be embedded PNG or JPEG. To review an animated asset, inspect it first and provide a selected pose with the reported player path, animation name and time in seconds. godot_review_capture produces a frame, and godot_review_inspect checks source, tool and artifact hashes and reports the latest attempt.
To open the interactive view, serve the receipt's relative bundle within the review directory:
python3 -m http.server --bind 127.0.0.1 --directory <review-directory>/<bundle>
Stop the server after review. Godot's headless mode does not render; capture uses a Godot Web export with the Compatibility renderer and WebGL 2. The review does not establish gameplay, collision, traversal, room architecture or appearance in another engine. Perform final acceptance in the consuming engine.
If inspection fails, preserve its output directory and inspect the receipt and process logs before retrying. If a capture has an unknown outcome, use godot_review_inspect to examine the latest attempt. A pending cleanup marker blocks another capture; resolve the owned processes and output before removing it.
Security
The server runs locally over MCP stdio. Report security concerns privately as described in SECURITY.md.
License
MIT. See LICENSE.
Metadata
Release files for cavi-godot-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cavi_godot_mcp-0.1.0.tar.gz | 62.5 kB | With provenance | Details for cavi_godot_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cavi_godot_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for cavi_godot_mcp-0.1.0-py3-none-any.whl |
Total release size: 89.5 kB
Release files / cavi_godot_mcp-0.1.0.tar.gz
| Download URL | cavi_godot_mcp-0.1.0.tar.gz |
|---|---|
| Size | 62.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fb07835f5d844ef28eea1f130934baa9a279ea154c5c25774aea25e729226cc8
|
|
BLAKE2b-256 checksum How to use checksums |
46b8ab0b676e2356bf3f8bce789202ef9cf515039ed4cd35f6e7b99d702bead0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logRelease files / cavi_godot_mcp-0.1.0-py3-none-any.whl
| Download URL | cavi_godot_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 27.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
086a0124dbdb9b7ead1b8f72e0271fef90668d971d775a41d25d55d177672205
|
|
BLAKE2b-256 checksum How to use checksums |
49f7869f9bfa16939066d835754703160e89bf1f1f1f5e499bc5c75129323eb4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logSecurity for cavi-godot-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for cavi_godot_mcp-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 17, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.