About this project

godot-mcp-bridge is an MCP (Model Context Protocol) server designed to integrate AI clients like Claude and Cursor directly into the Godot 4 editor. Unlike unidirectional servers, it is bidirectional, allowing the AI to track human editor activity (selections, saves, etc.) in real-time. Key capabilities include: - Live-Tree Editing: Mutates the active editor tree instead of overwriting files on disk, ensuring unsaved changes are preserved and supporting Godot's undo system. - Debugging & Testing: Includes a step-debugger via Godot's Debug Adapter (breakpoints, stack traces, variable evaluation) and integration with the GUT unit testing suite. - Extensive Toolset: Offers 231 tools categorized into toolsets (core, runtime, debug, code_intel, etc.), covering everything from GDScript LSP-based refactoring and scene scaffolding to multiplayer diagnostics and async headless exporting. - Runtime Control: Ability to drive the running game through input simulation, signal awaiting, and UI interaction by text. - Project Analysis: Tools for detecting circular dependencies, unused resources, and signal flow analysis. - Visualizer: A browser-based interactive explorer for mapping script relationships and editing code/properties. The system operates as a Node.js sidecar communicating with a Godot editor plugin via WebSockets, supporting both stdio and HTTP clients.