godot-devtool

Overview

godot-devtool is a comprehensive MCP server that enables AI assistants to interact with Godot 4 projects through multiple transport routes. It provides native, headless, editor, and runtime routes for various workflows including project setup, live editing, runtime testing, and multi-instance management. The server uses stdio communication with optional WebSocket bridging for advanced editor and runtime features. It maintains connection state through project paths, context, and session identifiers, allowing multiple MCP clients to share bridge ports efficiently.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_godot_version

  Get the installed Godot engine version

  Try:What version of Godot is installed?Try:Check Godot version
• get_capabilities

  Get available tools and their schemas with optional filtering

  Try:What tools are available?Try:List all MCP capabilitiesTry:Get schemas for editor tools
• plugin_install

  Install the godot-devtool plugin in a Godot project

  Try:Install the devtool plugin in my projectTry:Add godot-devtool to E:/my-game
• plugin_status

  Check the installation status of the godot-devtool plugin

  Try:Is the devtool plugin installed?Try:Check plugin connection status
• get_project_info

  Retrieve metadata about a Godot project

  Try:Get info about my Godot projectTry:Show project metadata
• run_project

  Run the Godot project and capture output

  Try:Run my gameTry:Start the Godot projectTry:Launch the project
• stop_project

  Stop the currently running Godot project

  Try:Stop the gameTry:End the running projectTry:Kill the Godot instance
• list_projects

  List Godot projects in a directory

  Try:What Godot projects are in this folder?Try:List all available projects
• project_get_settings

  Read Godot project.godot settings by section or section/key list

  Try:Get project settingsTry:Show config settings
• project_set_setting

  Update Godot project.godot settings with dry-run preview

  Try:Change a project settingTry:Update config value
• run_project_checks

  Run stable project checks for CI, review, and release workflows

  Try:Run project validationTry:Check for issues in my project
• browser_visualizer_start

  Start a local read-only dashboard for bridge status and visualization

  Try:Start the visualizer dashboardTry:Open the bridge status page

Comparable tools

Installation

{
  "mcpServers": {
    "godot-devtool": {
      "command": "node",
      "args": ["E:/godot-devtool/build/index.js"],
      "env": {
        "GODOT_PATH": "D:/Program Files/Godot/Godot_v4.x.exe",
        "GODOT_DEVTOOL_WS_PORT": "8766"
      }
    }
  }
}

git clone https://github.com/wangdiandao/godot-devtool.git
cd godot-devtool
npm install
npm run build

FAQ

What is the default WebSocket port for the bridge?

The default WebSocket port is 8766, which can be configured via GODOT_DEVTOOL_WS_PORT environment variable.

Does this MCP server require the Godot editor to be running?

No, it supports both native/headless routes that work without the editor and editor/runtime routes that require the editor or game to be running.

Compare godot-devtool with