Skip to main content

Cavi Godot MCP

A frog king on a turntable, inspected by an otter curator

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)

Source distribution for cavi-godot-mcp 0.1.0
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)

Table of built distributions (wheels) for cavi-godot-mcp 0.1.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page