godot-dap

The Godot DAP MCP Server enables AI agents to debug Godot games by bridging Claude Code (or any MCP client) to Godot's built-in Debug Adapter Protocol (DAP). It provides a structured set of capabilities from core debugging (connect, set/clear breakpoints, control execution) to runtime inspection (stack traces, locals, globals, object inspection) and scene launching. With this server, clients can orchestrate debugging sessions, drive execution, evaluate expressions, and navigate Godot-based projects through a consistent MCP interface. You can leverage its event-driven architecture to handle complex interleaved DAP events while benefiting from robust error handling and path resolution.

To use it, start the MCP server (via Docker in this setup) and connect your MCP client to the server. From there you can attach to a running Godot editor, set breakpoints, launch scenes, and then issue commands like stepping over, stepping into, or evaluating GDScript expressions. The server presents tools focused on Godot-specific interactions (path resolution for res:// and absolute paths, Godot-type formatting) to streamline debugging sessions and integrate with automated workflows.

Prerequisites:

• Docker installed and running on your host
• Access to the MCP client (e.g., Claude Code) or any MCP client that can connect to the MCP server

Installation steps:

1. Pull or build the MCP server image (example if using a prebuilt image): docker pull godot-dap-mcp-server:latest

2. Run the MCP server container (as a background service or foreground for debugging): docker run -it --rm -p 8080:8080 godot-dap-mcp-server:latest

3. If you prefer building from source (advanced):

   • Ensure Go is installed and configured (Go 1.20+ recommended)
   • Clone the repository containing the MCP server
   • Build: go build -o godot-dap-mcp-server cmd/godot-dap-mcp-server/main.go
   • Run: ./godot-dap-mcp-server

4. Connect an MCP client to the server using the provided endpoint (default or configured port).

Notes:

• The Docker deployment assumes a built image named godot-dap-mcp-server-mcp-server (adjust image name as needed).
• If you build locally, ensure the binary has execution permissions and that any required runtime dependencies are present.

Tips and common issues:

• Ensure Godot Editor is running with a compatible version (as per README, integration relies on Godot's DAP server).
• If breakpoints do not hit, verify path translation (res:// to absolute paths) and that the correct project path is passed to the debugger APIs.
• When using Docker, expose appropriate ports and mount project directories as needed to enable path resolution and project access.
• Enable verbose logs during initial setup to diagnose connection or protocol issues between the MCP client and this server.
• Some advanced features (like setVariable) may be disabled due to upstream limitations; check the current capabilities in the documentation.
• Regularly pull updates from the repository to incorporate fixes and improvements related to Godot compatibility and DAP handling.