godot-mcp-setup（godot MCP 设置）

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