godot-mcp-pro MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

169 MCP tools across 23 categories for comprehensive Godot 4 development
Real-time WebSocket connection with auto-reconnect and heartbeat monitoring
Full UndoRedo integration — all node/property operations are reversible
Smart type parsing for Vector2, Color, hex codes, and Godot-specific types
Three modes: Full (169 tools), Lite (80), Minimal (35) for different client limits

实时演示

实际使用效果

godot-mcp-pro-2.replay ▶ 就绪

0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "godot-mcp-pro-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "godot-mcp-pro-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/youichi-uda/godot-mcp-pro"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json

{
  "context_servers": {
    "godot-mcp-pro-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/youichi-uda/godot-mcp-pro"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add godot-mcp-pro-2 -- TODO 'See README: https://github.com/youichi-uda/godot-mcp-pro'

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： godot-mcp-pro

How to build a Godot scene with AI using Godot MCP Pro

👤 Godot developers who want AI-assisted scene creation ⏱ ~20 min beginner

何时使用： You want to quickly prototype a game scene by describing it in natural language.

前置条件

Godot 4 with MCP Pro plugin — Copy addons/godot_mcp/ to your project, enable in Project Settings → Plugins
Node.js MCP server — cd server && npm install && npm run build

步骤

Describe the scene

Create a 2D platformer level with a player CharacterBody2D, 5 platforms as StaticBody2D, and a goal area. Set up collision shapes for all.✓ 已复制

→ Scene tree created with all nodes, collision shapes, and proper hierarchy
Add scripts

Attach a movement script to the player with gravity, jump, and horizontal movement. Use Input.is_action_pressed for inputs.✓ 已复制

→ GDScript attached and functional
Test the level

Start a playtest and tell me if the player can reach the goal. Check for collision issues.✓ 已复制

→ Playtest results with observations

结果： A playable prototype level built entirely through natural language.

注意事项

Too many tools overwhelm some MCP clients — Switch to Lite (80 tools) or Minimal (35) mode if your client struggles with the full set

搭配使用： filesystem

Create and iterate on animations in Godot with AI assistance

👤 Game developers working on character animations and effects ⏱ ~15 min intermediate

何时使用： You want to create, tweak, or debug animations without manually editing keyframes.

前置条件

Godot MCP Pro connected — Plugin enabled and MCP server running

步骤

Create an animation

Create an AnimationPlayer on the player node with a 'walk' animation: translate the sprite 4 pixels up and down over 0.4 seconds, looping.✓ 已复制

→ Animation created with keyframes set
Preview and adjust

Play the walk animation. It looks too fast — slow it down to 0.6 seconds and add an ease-in-out curve.✓ 已复制

→ Animation updated with new timing and easing

结果： Polished animation created and refined through iterative AI feedback.

注意事项

Complex AnimationTree setups are hard to describe in natural language — Build the AnimationTree structure step by step, one blend node at a time

组合

与其他 MCP 搭配，撬动十倍杠杆

godot-mcp-pro-2 + filesystem

Generate and save GDScript files alongside scene modifications

Create an enemy AI script with patrol and chase states, save it as res://scripts/enemy_ai.gd, and attach it to the enemy node.✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用
create_node	type: str, name: str, parent_path?: str	Add a new node to the scene tree
set_property	node_path: str, property: str, value: any	Set any property on a node (supports UndoRedo)
attach_script	node_path: str, code: str	Attach a GDScript to a node
create_animation	player_path: str, name: str, keyframes: obj	Create an animation with keyframes
run_scene	scene_path?: str	Start a playtest of the current or specified scene
get_scene_tree	none	Get the current scene tree structure

成本与限制

运行它的成本

API 配额: N/A — fully local WebSocket connection
每次调用 Token 数: 100–500 tokens per tool call
费用: $5 one-time purchase — includes lifetime updates
提示: Use Minimal mode (35 tools) if you only need basic scene and script operations.

安全

权限、密钥、影响范围

凭据存储： N/A — local WebSocket connection only

数据出站： All communication is local between MCP server and Godot editor (localhost WebSocket)

故障排查

常见错误与修复

WebSocket connection failed

Ensure the Godot plugin is enabled and the Node.js server is running. Check the port in .mcp.json matches the plugin settings.

验证： Check Godot's output panel for MCP plugin messages

Tool count exceeds client limit

Switch to Lite (80 tools) or Minimal (35 tools) mode in the MCP configuration.

验证： Update the mode parameter in .mcp.json

Property not updating

Some properties require the scene to be saved and reloaded. Try saving the scene after the change.

验证： Check the Godot Inspector panel for the property value

替代方案

godot-mcp-pro 对比其他方案

替代方案	何时用它替代	权衡
Godot MCP (free community)	You want a free alternative with fewer features	Fewer tools but no cost

godot-mcp-pro

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： godot-mcp-pro

How to build a Godot scene with AI using Godot MCP Pro

前置条件

步骤

注意事项

Create and iterate on animations in Godot with AI assistance

前置条件

步骤

注意事项

组合

与其他 MCP 搭配，撬动十倍杠杆

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

godot-mcp-pro 对比其他方案

更多

资源