About this project

Breakpoint MCP is a Model Context Protocol server designed to connect AI assistants (such as Claude) to the Godot game engine (4.2+). Unlike basic authoring tools, it acts as a full client for Godot's built-in Language Server Protocol (LSP) and Debug Adapter Protocol (DAP), allowing AI agents to perform deep technical tasks including setting breakpoints, stepping through code, and inspecting real program state for both GDScript and C#. The server is organized into four capability planes: - Plane A (Live Editor): Handles scene/node/resource CRUD operations with full undo/redo support via an editor plugin. - Plane B (Headless CLI): Manages project execution, exporting, importing, and version control (Git) operations. - Plane C (Runtime Bridge): Provides live access to the running game's SceneTree, property manipulation, and runtime verification (assertions and screenshot diffs). - Plane D (Semantic & Debugging): Provides completion, diagnostics, and a full step-debugger for GDScript and C#. Key features include a secure-by-default trust model where high-risk tools are disabled by default, local-only communication via loopback sockets, and the ability to load specific toolsets to reduce token overhead for the AI model.