godot-devtool-project-setup

name	godot-devtool-project-setup
description	Use with godot-devtool when installing the addon, checking plugin state, configuring a Godot project, or preparing export/project settings.
metadata	{"version":"3.2.1","mcp_server":"godot-devtool"}

Godot Devtool Project Setup

Load this after the godot-devtool router when the task is install, upgrade, project inspection, settings, InputMap, autoload, export, or bridge-port diagnosis.

Start

Use the lightweight catalog first:

get_capabilities { "workflow": "project_setup", "includeSchemas": true }

Then inspect:

get_godot_version
get_project_info
plugin_status

If the project path is unknown, call list_projects for a focused parent directory.

Install Or Upgrade

Use:

plugin_install { "projectPath": "...", "overwrite": true, "websocketPort": 8766 }
plugin_status

Require evidence that addon files are installed, the runtime autoload is present, bridge config uses the intended port, and no unexpected occupied-port diagnostic blocks the listener.

If port 8766 is occupied:

plugin_cleanup_port { "port": 8766 }

Only stop a listener when the dry-run result proves it is a stale godot-devtool process or the user explicitly approves the exact PID.

Configure

Prefer structured project tools over editing project.godot by hand:

project_get_settings
project_set_setting
project_input_action
get_autoload
add_autoload
remove_autoload
get_export_presets
check_export_presets
update_export_preset
export_matrix
generate_ci_snippet

Run run_project_checks before finishing broader project setup work.