Files

T

joywayerandClaude Opus 4.8 e65066a8fb chore: 重命名 Tools/godot-mcp-pro-v1.15.1 → Tools/godot-mcp-pro，更新 .mcp.json

- 去掉版本号后缀，路径更稳定（后续更新工具不必再改 .mcp.json）
- .mcp.json 指向新路径 server/build/index.js
- server 依赖已 npm install 就绪；node_modules 由 .gitignore 忽略，未入库

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

2026-07-20 15:37:18 +08:00

1.6 KiB

Raw Blame History

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

Copy the addons/godot_mcp/ folder into your Godot project
Open Project → Project Settings → Plugins
Find "Godot MCP Pro" and click Enable
You should see "MCP Server" appear in the bottom panel
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

1.6 KiB Raw Blame History