Godot DevTool
Godot 4 MCP server for AI-assisted project inspection, editing, validation, and runtime automation.
What is Godot DevTool?
Godot DevTool is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to godot 4 mcp server for ai-assisted project inspection, editing, validation, and runtime automation.
Godot 4 MCP server for AI-assisted project inspection, editing, validation, and runtime automation.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Godot 4 MCP server for AI-assisted project inspection, editi
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx godot-devtoolConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Godot DevTool
Godot DevTool is a Godot 4 MCP server built in TypeScript that enables AI assistants to inspect, edit, validate, and automate Godot projects through natural language. It combines native file-based inspection, headless Godot operations, live editor control via a WebSocket plugin, and runtime automation through an autoload bridge — all exposed as a structured set of MCP tools. Game developers use it to let agents like Claude Code or Cursor understand project structure, run blast-radius checks before edits, simulate input during gameplay, and manage plugin installation, without the agent having to read dozens of GDScript files blindly.
Prerequisites
- Node.js 18 or higher
- Godot 4.x installed (set GODOT_PATH env var if 'godot' is not on PATH)
- A Godot project containing a project.godot file
- An MCP-compatible client: Claude Code, Cursor, Cline, Roo Code, VS Code Copilot, or Codex
Download or build the server
Download the latest release zip (e.g. godot-devtool-build-3.2.0.zip) from the GitHub releases page and extract it to a stable path, or clone and build from source.
# Build from source:
git clone https://github.com/wangdiandao/godot-devtool.git
cd godot-devtool
npm install
npm run buildAdd the MCP server to your client configuration
Register godot-devtool in your MCP client config, pointing to the build/index.js entry and setting GODOT_PATH to your Godot executable.
Restart your MCP client
Restart Claude Code, Cursor, or your chosen client so it picks up the new MCP server. Verify the connection by calling get_godot_version.
Install the Godot plugin into your project
Ask the AI assistant to install the bundled Godot plugin into your project, or call plugin_install directly. The plugin enables live editor and runtime routes.
Enable the plugin in the Godot editor
Open your Godot project, then go to Project > Project Settings > Plugins > godot-devtool > Enable.
Verify capabilities
Ask your AI client to call get_capabilities to see available tools organized by workflow (project_setup, live_editor, runtime_test, etc.).
Godot DevTool Examples
Client configuration
Add this JSON block to your Claude Desktop claude_desktop_config.json to connect the Godot DevTool MCP server. Update paths and GODOT_PATH for your system.
{
"mcpServers": {
"godot-devtool": {
"command": "node",
"args": ["/path/to/godot-devtool/build/index.js"],
"env": {
"GODOT_PATH": "/path/to/Godot_v4.x",
"GODOT_DEVTOOL_WS_PORT": "8766"
}
}
}
}Prompts to try
Use these prompts with your MCP client connected to the Godot DevTool server.
- "Get the Godot version and list available capabilities for project_setup"
- "Install and verify the Godot plugin for my project at /path/to/my-godot-project"
- "Show me all scenes in the project and their node structure"
- "Take a screenshot of the running game"
- "What is the blast radius if I modify the Player script?"
- "Run the project and monitor debug output"Troubleshooting Godot DevTool
Port 8766 is already in use when bridge tools run
Call plugin_status to check if another godot-devtool process owns the port. If the listener is stale, call plugin_cleanup_port with kill=true. If a different process owns the port, change GODOT_DEVTOOL_WS_PORT to an unused port in your MCP config.
Runtime routes fail even though the game is running
The runtime bridge (autoload/DevtoolRuntime) must be registered in the project. Ensure plugin_install was called with the correct projectPath, the plugin is enabled in Project Settings, and you ran the project from Godot after enabling the plugin.
get_capabilities returns only a few entry tools
tools/list intentionally exposes only entry tools and category metadata. To see full tool schemas for a specific workflow, call get_capabilities with toolNames and includeSchemas=true, e.g.: get_capabilities {"toolNames":["plugin_install"],"includeSchemas":true}
Frequently Asked Questions about Godot DevTool
What is Godot DevTool?
Godot DevTool is a Model Context Protocol (MCP) server that godot 4 mcp server for ai-assisted project inspection, editing, validation, and runtime automation. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Godot DevTool?
Follow the installation instructions on the Godot DevTool GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Godot DevTool?
Godot DevTool works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Godot DevTool free to use?
Yes, Godot DevTool is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Godot DevTool Alternatives — Similar Developer Tools Servers
Looking for alternatives to Godot DevTool? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Godot DevTool in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Godot DevTool?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.