The Minimal Godot MCP server bridges Godot's native Language Server Protocol (LSP) and Debug Adapter Protocol (DAP) to AI coding assistants for GDScript validation and debugging.

• Check individual GDScript files for syntax errors, type errors, and code quality issues using get_diagnostics (fast, <1s)

• Scan entire Godot projects for problems across all .gd files with scan_workspace_diagnostics (excludes addons/ and .godot/ directories; slower, 5-30s for 100+ files)

• Get real-time console output from running Godot scenes including print statements, stdout, and stderr messages via get_console_output, with options to filter by category, time range, or limit entries

• Clear console buffer to manage memory and focus on new output using clear_console_output

• Auto-detect Godot workspace and connect to LSP/DAP ports without manual configuration, or use environment variables for custom setups

• Handle Godot editor restarts automatically with resilient connection management

• Minimize token usage with lightweight, focused responses optimized for AI coding assistants

• Zero-config integration works with Godot 3.2+ or 4.x without requiring additional plugins

Uses ESLint for code linting during development of the MCP server

Built with Node.js runtime for executing the MCP server implementation

Distributed as an npm package for easy installation and dependency management

Uses Prettier for code formatting during development of the MCP server

Uses Shields.io badges to display package version and license information in documentation

Implemented in TypeScript for type-safe development of the MCP server

1. Click on "Install Server".

2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.

3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Minimal Godot MCP check this GDScript for syntax errors"

That's it! The server will respond to your query, and you can continue using it as needed.

Here is a step-by-step guide with screenshots.