Godot MCP Pro는 Claude, Cursor 같은 AI 어시스턴트를 WebSocket을 통해 Godot 4 에디터에 직접 연결하는 175개 도구의 MCP 서버입니다. AI가 씬을 만들고, GDScript를 작성하고, 플레이어 입력을 시뮬레이션하고, 실행 중인 게임을 검사하고, 3D 환경을 구축하고, 물리를 설정하고, 파티클과 오디오를 관리하는 모든 작업을 단 하나의 대화로 처리합니다. $15 평생 결제이며 Windows, macOS, Linux에서 작동합니다.
$15 평생 결제 · 평생 업데이트AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor
실시간 양방향 통신. 파일 폴링 없음. CLI 서브프로세스 생성 없음. 오직 즉각적인 피드백만.
AI로 구동되는 실전 Godot 4 가이드. 낡은 Godot 3 정보는 전혀 없습니다 — 모든 내용이 Godot 4.4+에서 검증되었습니다.
5분 만에 MCP Pro를 설정하고 Claude 또는 Cursor로 Godot 에디터를 직접 제어하세요. 플러그인 설치, 서버 빌드, AI 클라이언트 설정 — 이것만 하면 준비 완료입니다.
get_project_info get_scene_treeAI에게 씬, 스크립트, 시그널, UI까지 완성된 2D 게임을 만들어 달라고 요청하세요. 이 가이드는 빈 프로젝트에서 플레이 가능한 게임까지, 단 한 번의 AI 대화로 리버시 보드 게임을 만드는 과정을 안내합니다.
create_scene add_node create_script connect_signal play_sceneMixamo 애니메이션, AnimationTree 상태 머신, SpringArm3D 카메라, 지형까지 — 모두 AI가 만드는 3인칭 캐릭터 컨트롤러를 구축하세요. Godot 4의 CharacterBody3D, 물리 레이어, 애니메이션 블렌딩을 다룹니다.
add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3dGodot 4는 시그널을 Godot 3에서 대폭 개편했습니다. 더 이상 connect("signal", obj, "method")가 아니라 signal.connect(callable)를 사용합니다. AI에게 시그널 아키텍처 감사, 연결되지 않은 시그널 찾기, 프로젝트 전체의 시그널 흐름 시각화를 맡기세요.
analyze_signal_flow find_signal_connections get_signals connect_signalAI에게 게임 플레이 테스트를 맡기세요. 게임 실행, 키보드/마우스 입력 시뮬레이션, 스크린샷 캡처, 게임 상태 검증, 무작위 입력으로 스트레스 테스트까지. 테스트 프레임워크가 필요 없습니다 — MCP Pro가 에디터 수준에서 모두 처리합니다.
play_scene simulate_key capture_frames assert_node_state run_stress_testGodot 4의 AnimationTree는 강력하지만 복잡합니다. AI에게 트랜지션이 있는 상태 머신 생성, 블렌드 트리 설정, 조건 구성, 파라미터 연결을 맡기세요. Godot 초보자가 가장 많이 막히는 부분을 몇 분 만에 해결합니다.
create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameterGodot 4는 PhysicsBody를 CharacterBody/RigidBody로 이름을 바꾸고 충돌 레이어 API를 변경했습니다. AI에게 충돌 셰이프 설정, 물리 레이어 올바른 구성, 레이캐스트 추가, 충돌 설정 감사를 맡겨 가장 흔한 물리 버그를 피하세요.
setup_collision set_physics_layers setup_physics_body get_collision_infoGodot 4는 기본값을 CPUParticles에서 GPUParticles2D/3D로 바꿨습니다. 내장 프리셋으로 불, 연기, 비, 눈, 불꽃을 만들거나, 방출 형태, 속도 곡선, 색상 그라디언트를 세밀하게 조정하세요 — 모두 자연어 프롬프트로 가능합니다.
create_particles apply_particle_preset set_particle_color_gradient set_particle_material5분 안에 AI 어시스턴트를 Godot에 연결하세요.
addons/godot_mcp/를 Godot 프로젝트에 복사하세요. 프로젝트 > 프로젝트 설정 > 플러그인에서 활성화합니다. 플러그인이 에디터 내부에서 WebSocket 서버를 자동으로 시작합니다.
server/ 디렉터리에서 npm install && npm run build를 실행하세요. AI 클라이언트와 Godot 플러그인을 연결하는 TypeScript MCP 서버를 컴파일합니다.
AI 클라이언트의 MCP 설정에 서버를 추가하세요. Godot를 열면 AI 어시스턴트가 175개 도구에 실시간으로 접근합니다 — 씬 생성, 스크립트 편집, 입력 시뮬레이션, 실행 중인 게임 분석까지.
AI가 Godot 프로젝트를 2D와 3D로 구축, 검사, 테스트, 수정하는 데 필요한 모든 것.
get_project_info metadata & autoloadsget_filesystem_tree recursive file treesearch_files fuzzy/glob searchget/set_project_settings read & writeuid_to_project_path UID conversionproject_path_to_uid path conversionget_scene_tree live hierarchyget_scene_file_content raw .tscncreate_scene new scenesopen_scene delete_scene save_sceneadd_scene_instance prefab-like instancingplay_scene stop_sceneadd_node delete_node rename_nodeduplicate_node deep copymove_node reparentupdate_property smart type parsingget_node_properties inspect all propsadd_resource shapes, materialsset_anchor_preset UI anchorsconnect_signal disconnect_signallist_scripts project-wide overviewread_script create_scriptedit_script search/replace & insertattach_script attach to nodesget_open_scripts editor awarenessget_editor_errors errors & stack tracesget_editor_screenshot editor viewportget_game_screenshot running gamecompare_screenshots visual diff NEWexecute_editor_script run GDScriptget_signals inspect signal connectionsreload_plugin reload_projectclear_outputsimulate_key keyboard with modifierssimulate_mouse_click positioned clickssimulate_mouse_move absolute/relativesimulate_action Godot InputActionssimulate_sequence multi-event combosget_game_scene_tree live game hierarchyget/set_game_node_properties runtime inspection & tweakingexecute_game_script run code in live gamecapture_frames multi-frame screenshotsmonitor_properties property timelinestart/stop/replay_recording input recording & replay NEWfind_nodes_by_script get_autoloadfind_ui_elements click_button_by_text NEWwait_for_node batch_get_properties NEWlist_animations create_animationadd_animation_track value/position/bezierset_animation_keyframe insert keysget_animation_info tracks & keyframesremove_animationcreate_animation_tree with state machine rootget_animation_tree_structure full tree inspectionadd/remove_state_machine_state manage statesadd/remove_state_machine_transition with conditionsset_blend_tree_node Add2, Blend2, TimeScaleset_tree_parameter conditions & blendstilemap_set_cell place tilestilemap_fill_rect fill regionstilemap_get_cell read tile datatilemap_clear clear alltilemap_get_info tile set sourcestilemap_get_used_cells query used cellsadd_mesh_instance primitives & .glb/.gltf importsetup_lighting sun/indoor/dramatic presetsset_material_3d full PBR material setupsetup_environment sky, fog, glow, SSAO, SSRsetup_camera_3d projection, FOV, cull maskadd_gridmap GridMap with MeshLibrarysetup_collision auto-detect 2D/3D shapesset/get_physics_layers layer & mask managementadd_raycast RayCast2D/3Dsetup_physics_body CharacterBody & RigidBody configget_collision_info full collision auditcreate_particles GPUParticles 2D/3Dset_particle_material direction, velocity, emission shapeset_particle_color_gradient color ramp stopsapply_particle_preset fire, smoke, rain, snow, sparksget_particle_info full config inspectionsetup_navigation_region auto-detect 2D/3Dbake_navigation_mesh mesh baking & polygon gensetup_navigation_agent pathfinding & avoidanceset_navigation_layers layer managementget_navigation_info full nav auditget_audio_bus_layout full bus overviewadd_audio_bus set_audio_bus create & configureadd_audio_bus_effect reverb, delay, compressor, EQadd_audio_player 2D/3D audio playersget_audio_info subtree audio auditcreate_theme new Theme resourceset_theme_color color overridesset_theme_constant constant overridesset_theme_font_size font sizesset_theme_stylebox StyleBoxFlatget_theme_info inspect overridescreate_shader with templatesread_shader edit_shaderassign_shader_material to nodesset_shader_param set uniformsget_shader_params read all paramsread_resource inspect .tres propertiesedit_resource modify & savecreate_resource new .tres of any typefind_nodes_by_type search by classfind_signal_connections audit signalsbatch_set_property bulk changesfind_node_references cross-file searchget_scene_dependencies dependency graphcross_scene_set_property project-wide changes NEWrun_test_scenario automated test sequencesassert_node_state property assertionsassert_screen_text UI text verificationrun_stress_test random input fuzzingget_test_report pass/fail summaryfind_unused_resources dead asset detectionanalyze_signal_flow signal graph mappinganalyze_scene_complexity node count & depthfind_script_references cross-project searchdetect_circular_dependencies cycle detectionget_project_statistics full project overviewget_performance_monitors FPS, memory, physicsget_editor_performance quick summarylist_export_presets configured presetsexport_project build commandsget_export_info paths & templates무료 대안에는 없는 기능들.
노드 간 시그널을 연결, 해제, 검사합니다. 어떤 경쟁 제품도 지원하지 않는 기능입니다. Godot의 이벤트 기반 아키텍처에 필수적입니다.
모든 변경 사항이 Godot의 UndoRedo 시스템을 거칩니다. AI가 한 모든 작업을 Ctrl+Z로 되돌릴 수 있습니다. 무료 대안은 실행 취소 없이 씬을 직접 수정합니다.
Vector2(100,200), #ff0000, Color(1,0,0) — AI가 문자열을 보내면 우리가 적절한 Godot 타입으로 자동 파싱합니다.
하트비트, 자동 재연결(지수 백오프), 포트 자동 스캔이 있는 WebSocket. 연결 끊김 없음, 수동 재시작 없음.
오류에는 구조화된 코드와 실행 가능한 제안이 포함됩니다. AI가 알 수 없는 실패에 막히지 않고 스스로 수정할 수 있습니다.
11개의 노드 도구: 추가, 삭제, 이름 변경, 복제, 이동/재부모화, 프로퍼티 업데이트, 리소스 추가, 앵커 설정. 이 모든 것을 다루는 경쟁 제품은 없습니다.
AI에게 게임을 플레이하게 하세요. 키보드, 마우스, InputAction을 시뮬레이션합니다. 입력 세션을 녹화하고 프레임 단위 정밀 타이밍으로 재생하여 회귀 테스트를 수행합니다.
실시간 게임 검사를 위한 15개 도구. 런타임에 프로퍼티를 읽고 수정하고, 프레임을 캡처하고, 프로퍼티 변경을 모니터링하고, UI 요소를 찾고, 텍스트로 버튼을 클릭하고, 노드가 나타날 때까지 대기합니다.
애니메이션 생성, 트랙 추가, 키프레임 삽입. 트랜지션과 조건이 있는 상태 머신 구축. Add2, Blend2, TimeScale 노드로 블렌드 트리를 구성합니다.
메시 추가(프리미티브 또는 .glb/.gltf), 프리셋으로 조명 설정, PBR 머티리얼 구성, 하늘/안개/SSAO/SSR로 환경 생성, 카메라 배치, GridMap 구축.
충돌 셰이프 설정, 물리 바디 구성, 충돌 레이어 관리, 레이캐스트 추가. 내비게이션 영역 생성, 내비 메시 베이크, 경로 탐색 에이전트 구성.
프리셋(불, 연기, 비, 눈)으로 GPU 파티클 시스템을 생성합니다. 오디오 버스 관리, 효과 추가(리버브, 딜레이, 컴프레서), 2D/3D 오디오 플레이어 배치.
템플릿에서 셰이더 생성, GLSL 코드 편집, ShaderMaterial 할당, 런타임에 유니폼 조정. AI 채팅을 벗어나지 않고 완전한 셰이더 워크플로우를 처리합니다.
입력 시뮬레이션과 어서션으로 자동 테스트 시나리오를 실행합니다. 화면의 UI 텍스트를 검증합니다. 무작위 입력 퍼징으로 스트레스 테스트를 합니다. 합격/불합격 테스트 리포트를 생성합니다.
사용하지 않는 리소스 찾기, 시그널 흐름 매핑, 씬 복잡도 분석, 순환 종속성 감지, 스크립트 참조 검색, 전체 프로젝트 통계 확인.
타입으로 노드 찾기, 시그널 연결 감사, 여러 씬에 걸쳐 프로퍼티 일괄 설정, 모든 프로젝트 파일 검색, 종속성 분석. 대규모로 리팩터링하세요.
AI 어시스턴트에게 요청할 수 있는 실제 예시 — 그냥 됩니다.
AI가 씬을 만들고, 스크립트를 작성하고, 시그널을 연결하고, UI를 설정하고, 게임을 실행합니다 — 모두 한 번의 대화로. 데모 영상을 확인하세요.
AI가 메시를 추가하고, 조명 프리셋을 구성하고, PBR 머티리얼을 설정하고, 환경 설정을 조정합니다 — 모두 에디터 API를 통해 완전한 실행 취소/다시 실행과 함께.
AI가 게임을 실행하고, 키보드 입력을 시뮬레이션하고, 스크린샷을 캡처하고, 런타임 노드 프로퍼티를 검사하고, 게임 상태를 검증합니다 — 자동 QA 워크플로우를 가능하게 합니다.
AI가 에디터의 오류 출력과 스크립트 컴파일 오류를 읽고, 문제를 파악하고, 스크립트를 편집해 수정하고, 수정 사항을 검증합니다 — 오류 메시지를 복사해 붙여넣을 필요 없는 촘촘한 피드백 루프.
AI가 GPU 파티클을 생성하고, 방출 형태와 속도를 구성하고, 색상 그라디언트를 적용하거나, 내장 프리셋(불, 연기, 비, 눈, 불꽃)을 사용해 즉각적인 결과를 냅니다.
AI가 모든 씬을 검색하고, 일치하는 노드를 찾고, 프로퍼티를 일괄 변경합니다 — 수동 클릭으로 몇 분 걸릴 작업을 몇 초 만에 끝냅니다.
Godot MCP Pro가 대안들과 어떻게 비교되는지.
| 기능 | Godot MCP Pro | GDAI MCP ($19) | godot-mcp (free) |
|---|---|---|---|
| 전체 도구 수 | 175 | ~30 | 13 |
| 카테고리 | 23 | ~8 | 4 |
| 연결 | WebSocket + heartbeat | stdio (Python) | Headless CLI |
| Undo/Redo | Yes | Yes | No |
| 시그널 관리 | Yes | No | No |
| 노드 이름 변경/복제/이동 | Yes | No | No |
| 스마트 타입 파싱 | Yes | Limited | No |
| 입력 시뮬레이션 | Key / Mouse / Action / Sequence | Yes (basic) | No |
| 런타임 분석 | 15개 도구 (트리, 프로퍼티, 프레임, UI, 녹화) | No | No |
| 3D 씬 도구 | Mesh, Lighting, PBR, Environment, Camera | No | No |
| 물리 설정 | Collision, Layers, Raycasts, Bodies | No | No |
| 파티클 | GPU 2D/3D with presets | No | No |
| 내비게이션 | Region, Mesh baking, Agent | No | No |
| 오디오 | Buses, Effects, Players | No | No |
| AnimationTree | State machine, Blend tree | No | No |
| 자동 테스트 | 시나리오, 어서션, 스트레스 테스트 | No | No |
| 코드 분석 | 사용하지 않는 리소스, 시그널 흐름, 복잡도 | No | No |
| 스크린샷 | 에디터 + 게임 + 시각적 차이 | Yes | No |
Godot MCP Pro에 대해 자주 묻는 질문.
Godot MCP Pro는 Claude, Cursor, Cline 같은 AI 어시스턴트를 WebSocket을 통해 Godot 4 에디터에 직접 연결하는 프리미엄 MCP(Model Context Protocol) 서버입니다. 씬 조작, 애니메이션, 3D 모델링, 물리 설정, 파티클 효과, 오디오 관리, 셰이더 편집, 입력 시뮬레이션, 런타임 분석, 자동 테스트에 걸쳐 23개 카테고리의 175개 도구를 제공합니다.
프로젝트에 Godot MCP Pro 플러그인을 설치하고, 프로젝트 설정 > 플러그인에서 활성화한 다음, npm install && npm run build로 MCP 서버를 빌드하고, .mcp.json에 추가하세요. Claude(Code 또는 Desktop)가 WebSocket을 통해 Godot 에디터에 자동으로 연결되어 175개 도구 전부에 접근합니다.
Claude Code, Claude Desktop, Cursor, Cline 확장이 있는 VS Code, Windsurf 등 Model Context Protocol 표준을 지원하는 모든 MCP 호환 AI 클라이언트가 작동합니다. MCP 프로토콜은 개방형 표준이므로 새로운 클라이언트가 정기적으로 추가됩니다.
네. Godot MCP Pro는 메시 프리미티브 추가나 .glb/.gltf 모델 임포트, 프리셋으로 조명 설정, PBR 머티리얼 구성, 하늘/안개/SSAO/SSR로 환경 생성, 카메라 배치, GridMap 구축을 위한 전용 3D 도구를 포함합니다. 물리, 내비게이션, 파티클 도구와 결합하면 AI가 완전한 3D 게임 씬을 구축할 수 있습니다.
네. 런타임 분석 스위트에는 AI가 게임을 실행하고, 키보드/마우스/액션 입력을 시뮬레이션하고, 스크린샷을 캡처하고, 실시간 씬 트리를 검사하고, 런타임에 프로퍼티를 읽고 수정하고, 입력 세션을 녹화 및 재생하고, UI 요소를 찾고, 텍스트로 버튼을 클릭하고, 어서션이 있는 자동 테스트 시나리오를 실행하게 하는 15개 도구가 포함됩니다.
네. Godot MCP Pro는 Cursor, VS Code + Cline, Windsurf, Claude Code CLI, Claude Desktop 및 기타 모든 MCP 호환 클라이언트에서 작동합니다. 에디터 설정에서 MCP 서버를 구성하면 WebSocket을 통해 연결됩니다.
Godot 4.4 이상(Godot 4.6에서 테스트됨)과 Node.js 18+가 필요합니다. Windows, macOS, Linux에서 작동합니다.
Godot MCP Pro는 무료 대안의 13~32개에 비해 175개 도구를 제공합니다. 독점 기능으로는 완전한 실행 취소/다시 실행, 시그널 관리, 녹화/재생이 있는 입력 시뮬레이션, 15개 도구 런타임 분석 스위트, 3D 씬 구축, 물리 설정, 파티클 시스템, 오디오 버스 관리, 내비게이션 메시 도구, AnimationTree 상태 머신, 자동 테스트, 코드 분석이 있습니다.
네. GDScript 에디터 플러그인(addons/godot_mcp/)은 완전한 오픈 소스이며 GitHub에서 이용할 수 있습니다. 구매 전에 플러그인이 에디터와 어떻게 통신하는지 정확히 확인할 수 있습니다. MCP 서버(TypeScript)는 유료 다운로드에 포함됩니다.
아니요. Godot MCP Pro는 $15 평생 결제로 평생 업데이트, 무제한 프로젝트, 무제한 기기, Discord 지원이 제공됩니다. 반복 요금 없음, 좌석 제한 없음.
5분 안에 실행하세요.
다운로드에서 addons/godot_mcp/ 폴더를 Godot 프로젝트의 루트 디렉터리에 복사하세요. 그런 다음 플러그인을 활성화합니다:
Project > Project Settings > Plugins > Godot MCP Pro > Enable
server/ 디렉터리에서 터미널을 여세요:
cd server npm install npm run build
AI 클라이언트의 MCP 설정 파일(예: Claude Code의 경우 .mcp.json)에 서버를 추가하세요:
{
"mcpServers": {
"godot-mcp-pro": {
"command": "node",
"args": ["/path/to/server/build/index.js"]
}
}
}
플러그인이 활성화된 Godot 프로젝트를 여세요. 에디터 독의 상태 패널에 연결 상태가 표시됩니다. AI 어시스턴트를 시작하고 개발을 시작하세요 — 이제 Godot 에디터의 175개 도구에 직접 접근합니다.
한 번 결제하고 영원히 사용하세요. 평생 업데이트 포함.