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와 조합해 10배 효율

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
호출당 토큰: 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와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

godot-mcp-pro 다른 것과 비교

더 보기

리소스