godot-mcp-setup

Godot MCP Setup

Enables AI agents to install and configure the Godot MCP (Model Context Protocol) server for programmatic scene management.

When to Use This Skill

Use ONLY when:

• User explicitly requests MCP-based scene building
• User wants programmatic scene creation/modification
• User asks about scene automation tools

DO NOT suggest unless:

• User expresses interest in MCP functionality
• Alternative manual methods insufficient

Available Scripts

mcp_config_generator.gd

Tool script to generate the Claude Desktop config JSON for Godot MCP.

NEVER Do in MCP Setup

• NEVER suggest MCP for simple scene edits — MCP is for automation/batch operations. Single node addition? Use manual editor. MCP overhead (config + restart) wastes time.
• NEVER skip JSON syntax validation — Invalid JSON in claude_desktop_config.json = silent MCP failure. ALWAYS validate with ConvertFrom-Json before saving.
• NEVER forget to remind user to restart Claude Desktop — MCP changes require full app restart, NOT just new conversation. This is #1 user mistake.
• NEVER use global npm install without user permission — npm install -g modifies system. ALWAYS prefer npx (on-demand) unless user specifically wants global.
• NEVER assume Node.js is installed — Check node --version BEFORE attempting npx. Missing Node = cryptic "command not found" errors.

---

Installation Workflow

Step 1: Check if MCP is Already Installed

For PowerShell (Windows):

# Check if the Godot MCP server is configured
$mcpConfigPath = "$env:APPDATA\Claude\claude_desktop_config.json"
if (Test-Path $mcpConfigPath) {
    $config = Get-Content $mcpConfigPath | ConvertFrom-Json
    if ($config.mcpServers.godot) {
        Write-Host "Godot MCP server is already configured."
    }
}

Step 2: Install Godot MCP Server

Installation Command (npx):

# Install globally
npm install -g @modelcontextprotocol/server-godot

# OR use npx for on-demand execution
npx @modelcontextprotocol/server-godot

Step 3: Configure Claude Desktop

The MCP server must be registered in Claude Desktop's configuration file.

Configuration File Location:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Example Configuration:

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-godot"]
    }
  }
}

Step 4: Restart Claude Desktop

After configuration, the user must restart Claude Desktop for MCP changes to take effect.

Verification

After installation, verify the MCP tools are available by checking if mcp_godot_* tools are accessible.

Common Issues

Issue: MCP server not appearing after restart

• Solution: Verify the JSON syntax in claude_desktop_config.json
• Solution: Check that Node.js and npm are installed

Issue: Permission errors during installation

• Solution: Run PowerShell as Administrator on Windows

Reference

• Godot MCP Server: GitHub Repository
• MCP Protocol: Official Documentation

Related

• Master Skill: godot-master