# Clone into your project's addons directory
cd your-godot-project
mkdir -p addons
cd addons
git clone https://github.com/yurineko73/Godot-MCP-Native.git godot_mcp

# Default configuration
transport_mode = "http"  # HTTP mode for remote access
http_port = 9080         # Server port
auth_enabled = false     # Enable authentication
auth_token = ""          # Bearer token (if auth enabled)

npm install mcp-remote

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:9080/mcp"
      ]
    }
  }
}

{
  "mcpServers": {
    "godot-mcp": {
      "url": "http://localhost:9080/mcp"
    }
  }
}

{
  "mcpServers": {
    "godot-mcp": {
      "url": "http://localhost:9080/mcp",
      "headers": {
        "Authorization": "Bearer ${GODOT_MCP_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "godot-mcp": {
      "url": "http://localhost:9080/mcp",
      "type": "streamableHttp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

{
  "mcp": {
    "godot-mcp": {
      "type": "remote",
      "url": "http://localhost:9080/mcp"
    }
  }
}

[mcp_servers]

[mcp_servers.godot-mcp]
type = "streamableHttp"
url = "http://localhost:9080/mcp"

@mcp godot-mcp get-scene-tree

Show me the current scene structure

@mcp godot-mcp create-node

Create a Node3D called "Player" as a child of the root node

@mcp godot-mcp update-node-property

Set the Player's position to (0, 5, 0)

@mcp godot-mcp delete-node

Remove the Enemy node from the scene

@mcp godot-mcp duplicate-node

Duplicate the Coin node and place the copy under Collectibles

@mcp godot-mcp move-node

Move the UI node to be a child of CanvasLayer

@mcp godot-mcp rename-node

Rename "Player1" to "MainPlayer"

@mcp godot-mcp list-project-scripts

Show me all GDScript files in the project

@mcp godot-mcp read-script

Read the player.gd script

@mcp godot-mcp modify-script

Update the player movement script to include jump logic

@mcp godot-mcp create-script

Create a new script res://scripts/enemy.gd

@mcp godot-mcp attach-script

Attach res://scripts/player.gd to the Player node

@mcp godot-mcp execute-script

Execute: print(get_tree().root.get_child_count())

@mcp godot-mcp analyze-script

Analyze the structure of player.gd

@mcp godot-mcp validate-script

Check if enemy.gd has syntax errors

@mcp godot-mcp create-scene

Create a new scene with a CharacterBody3D root node at res://scenes/player.tscn

@mcp godot-mcp save-scene

Save the current scene

@mcp godot-mcp open-scene

Open res://scenes/main_menu.tscn

@mcp godot-mcp get-current-scene

What scene am I editing?

@mcp godot-mcp list-project-scenes

Show all scene files in the project

@mcp godot-mcp get-editor-state

What's the current editor status?

@mcp godot-mcp run-project

Run the game

@mcp godot-mcp stop-project

Stop the running game

@mcp godot-mcp get-editor-screenshot

Take a screenshot of the 3D viewport

@mcp godot-mcp select-node

Select the Player node and show it in the Inspector

@mcp godot-mcp get-inspector-properties

Show me all editable properties for the Camera3D node

@mcp godot-mcp set-anchor-preset

Set the UI panel to use the full rect anchor preset

@mcp godot-mcp connect-signal

Connect the Button's pressed signal to the Main node's _on_button_pressed method

@mcp godot-mcp batch-update-node-properties

Set multiple properties on Player: position (0,0,0), rotation (0,0,0), scale (1,1,1)

@mcp godot-mcp get-editor-logs

Show me the last 50 log entries

@mcp godot-mcp debug-print

Print debug message: "Player health initialized"

@mcp godot-mcp get-performance-metrics

Show current FPS and memory usage

@mcp godot-mcp install-runtime-probe

Add the MCP runtime probe to the current scene

@mcp godot-mcp get-runtime-scene-tree

Show the live scene tree of the running game

@mcp godot-mcp inspect-runtime-node

Inspect the Player node in the running game

@mcp godot-mcp update-runtime-node-property

Set the player's health to 100 in the running game

@mcp godot-mcp evaluate-runtime-expression

Evaluate: get_tree().paused = true

@mcp godot-mcp get-debugger-sessions

Show active debugger sessions

@mcp godot-mcp set-debugger-breakpoint

Set a breakpoint at player.gd:45

@mcp godot-mcp get-debug-stack-frames

Show the call stack when breaked

@mcp godot-mcp get-debug-stack-variables

Show local variables for frame 0

@mcp godot-mcp debug-step-over

Step over the current line

@mcp godot-mcp debug-continue

Resume execution

1. Create the character body:
   @mcp godot-mcp create-node
   Create a CharacterBody3D called "Player" as a child of root

2. Add a mesh:
   @mcp godot-mcp create-node
   Create a MeshInstance3D called "PlayerMesh" as a child of Player
   
   @mcp godot-mcp update-node-property
   Set PlayerMesh's mesh to a new BoxMesh

3. Add collision:
   @mcp godot-mcp create-node
   Create a CollisionShape3D called "Collision" as a child of Player
   
   @mcp godot-mcp add-resource
   Add a BoxShape3D resource to the Collision node

4. Create and attach script:
   @mcp godot-mcp create-script
   Create res://scripts/player.gd with movement logic
   
   @mcp godot-mcp attach-script
   Attach the player script to the Player node

1. Create CanvasLayer container:
   @mcp godot-mcp create-node
   Create a CanvasLayer called "UI" as a child of root

2. Add panel:
   @mcp godot-mcp create-node
   Create a Panel called "MenuPanel" as a child of UI
   
   @mcp godot-mcp set-anchor-preset
   Set MenuPanel to CenterTop preset

3. Add buttons:
   @mcp godot-mcp create-node
   Create a Button called "PlayButton" as a child of MenuPanel
   
   @mcp godot-mcp update-node-property
   Set PlayButton's text to "Play Game"

4. Connect signals:
   @mcp godot-mcp connect-signal
   Connect PlayButton's pressed signal to UI's _on_play_pressed method

1. Install probe:
   @mcp godot-mcp install-runtime-probe
   Add the MCP runtime probe to the scene

2. Run game:
   @mcp godot-mcp run-project
   Start the game

3. Inspect runtime state:
   @mcp godot-mcp get-runtime-scene-tree
   Show live scene structure
   
   @mcp godot-mcp inspect-runtime-node
   Inspect the Player node's current property values

4. Modify at runtime:
   @mcp godot-mcp update-runtime-node-property
   Set player health to 50 in the running game

5. Evaluate expressions:
   @mcp godot-mcp evaluate-runtime-expression
   Execute: print(get_tree().get_nodes_in_group("enemies").size())

1. Audit scene structure:
   @mcp godot-mcp audit-scene-inheritance
   Show inherited/instanced nodes in the current scene

2. Check node persistence:
   @mcp godot-mcp audit-scene-node-persistence
   Verify node ownership and save state

@mcp godot-mcp batch-scene-node-edits

Apply multiple edits in one undo action:
- Create a Node3D called "Enemies"
- Create 3 CharacterBody3D children
- Delete the old "Enemy" node

# In Project Settings > Godot MCP
auth_enabled = true
auth_token = "your-secret-token"

{
  "headers": {
    "Authorization": "Bearer your-secret-token"
  }
}

@mcp godot-mcp list-export-presets
Show configured export presets

@mcp godot-mcp validate-export-preset
Check if "Linux/X11" preset is valid

@mcp godot-mcp inspect-export-templates
Verify export templates are installed

@mcp godot-mcp read godot://script/current

Show me the script I'm currently editing