server-deploy/claude-dev-stack/godot-mcp-pro-v1.14.1/docs/installation.md

Installation Guide

Prerequisites

• Godot 4.3+ (tested with 4.6)
• Node.js 18+
• An MCP-compatible AI client (Claude Code, Claude Desktop, etc.)

Step 1: Godot Plugin

1. Copy the addons/godot_mcp/ folder into your Godot project
2. Open Project → Project Settings → Plugins
3. Find "Godot MCP Pro" and click Enable
4. You should see "MCP Server" appear in the bottom panel
5. The status should show "Waiting for connection..."

Step 2: Node.js Server

cd server
npm install
npm run build

This creates the compiled server in server/build/.

Step 3: MCP Client Configuration

Claude Code (.mcp.json)

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp-pro/server/build/index.js"]
    }
  }
}

Custom Port

Set the GODOT_MCP_PORT environment variable (default: 6505):

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/absolute/path/to/server/build/index.js"],
      "env": { "GODOT_MCP_PORT": "6510" }
    }
  }
}

Also update the port in plugin.gd (line 3: const PORT := 6505).

Troubleshooting

Plugin doesn't appear

• Make sure the addons/godot_mcp/ directory is inside your Godot project
• Check that plugin.cfg exists in the directory

Connection fails

• Verify the Godot editor is running with the plugin enabled
• Check the bottom panel "MCP Server" tab for status
• Ensure no firewall is blocking localhost port 6505

Tools timeout

• Commands have a 30-second timeout
• Large operations (full filesystem scan) may need the max_depth parameter