Kết nối AI với Godot 4
Thiết lập MCP Pro trong 5 phút và để Claude hoặc Cursor điều khiển trực tiếp trình soạn thảo Godot của bạn. Cài plugin, build máy chủ, cấu hình AI client — và bạn đã sẵn sàng.
get_project_info get_scene_treeGodot MCP Pro là một máy chủ MCP với 175 công cụ, kết nối các trợ lý AI như Claude và Cursor trực tiếp với trình soạn thảo Godot 4 qua WebSocket. Nó cho phép AI tạo cảnh, viết GDScript, mô phỏng input của người chơi, kiểm tra game đang chạy, dựng môi trường 3D, thiết lập vật lý, quản lý hạt và âm thanh — tất cả chỉ trong một cuộc trò chuyện. Mua một lần $15, hoạt động trên Windows, macOS và Linux.
Mua một lần $15 · Cập nhật trọn đờiMột câu lệnh → AI xây dựng một game Cờ lật hoàn chỉnh, khởi chạy nó và tự chơi thử bằng các cú nhấp chuột.
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor
Giao tiếp hai chiều thời gian thực. Không thăm dò tệp. Không sinh tiến trình con CLI. Chỉ có phản hồi tức thì.
Các hướng dẫn Godot 4 thực tế được hỗ trợ bởi AI. Không có thông tin Godot 3 lỗi thời — mọi thứ ở đây đều được kiểm thử trên Godot 4.4+.
Thiết lập MCP Pro trong 5 phút và để Claude hoặc Cursor điều khiển trực tiếp trình soạn thảo Godot của bạn. Cài plugin, build máy chủ, cấu hình AI client — và bạn đã sẵn sàng.
get_project_info get_scene_treeYêu cầu AI tạo một game 2D hoàn chỉnh — cảnh, script, tín hiệu, UI. Hướng dẫn này đưa bạn qua quá trình xây dựng game cờ bàn Cờ lật trong một cuộc trò chuyện AI duy nhất, từ dự án trống đến game có thể chơi được.
create_scene add_node create_script connect_signal play_sceneXây dựng bộ điều khiển nhân vật góc nhìn thứ ba với hoạt ảnh Mixamo, máy trạng thái AnimationTree, camera SpringArm3D và địa hình — tất cả do AI tạo ra. Bao gồm CharacterBody3D, lớp vật lý và trộn hoạt ảnh trong Godot 4.
add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3dGodot 4 đã cải tổ toàn bộ tín hiệu so với Godot 3. Không còn connect("signal", obj, "method") — hãy dùng signal.connect(callable). Hãy để AI kiểm tra kiến trúc tín hiệu của bạn, tìm các tín hiệu chưa được kết nối và trực quan hóa luồng tín hiệu trong toàn dự án.
analyze_signal_flow find_signal_connections get_signals connect_signalHãy để AI chơi thử game của bạn. Khởi chạy game, mô phỏng input bàn phím/chuột, chụp ảnh màn hình, kiểm tra trạng thái game và chạy stress test với input ngẫu nhiên. Không cần framework kiểm thử — MCP Pro xử lý tất cả ở cấp trình soạn thảo.
play_scene simulate_key capture_frames assert_node_state run_stress_testAnimationTree của Godot 4 rất mạnh mẽ nhưng phức tạp. Hãy để AI tạo máy trạng thái với các chuyển tiếp, thiết lập blend tree, cấu hình điều kiện và nối các tham số — trở ngại phổ biến nhất với người mới học Godot, được giải quyết trong vài phút.
create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameterGodot 4 đã đổi tên PhysicsBody thành CharacterBody/RigidBody và thay đổi API lớp va chạm. Hãy để AI thiết lập hình dạng va chạm, cấu hình lớp vật lý đúng cách, thêm raycast và kiểm tra thiết lập va chạm của bạn — tránh các lỗi vật lý phổ biến nhất.
setup_collision set_physics_layers setup_physics_body get_collision_infoGodot 4 đã thay CPUParticles mặc định bằng GPUParticles2D/3D. Tạo lửa, khói, mưa, tuyết và tia lửa bằng các preset dựng sẵn, hoặc tinh chỉnh hình dạng phát xạ, đường cong vận tốc và dải màu — tất cả thông qua câu lệnh ngôn ngữ tự nhiên.
create_particles apply_particle_preset set_particle_color_gradient set_particle_materialKết nối trợ lý AI của bạn với Godot trong chưa đầy 5 phút.
Sao chép addons/godot_mcp/ vào dự án Godot của bạn. Bật nó trong Project > Project Settings > Plugins. Plugin sẽ tự động khởi động một máy chủ WebSocket bên trong trình soạn thảo.
Chạy npm install && npm run build trong thư mục server/. Lệnh này biên dịch máy chủ MCP viết bằng TypeScript, làm cầu nối giữa AI client và plugin Godot.
Thêm máy chủ vào cấu hình MCP của AI client. Mở Godot, và trợ lý AI của bạn giờ có quyền truy cập thời gian thực vào 175 công cụ — tạo cảnh, chỉnh sửa script, mô phỏng input và phân tích game đang chạy.
Mọi thứ bạn cần để AI xây dựng, kiểm tra, kiểm thử và chỉnh sửa dự án Godot của bạn ở cả 2D và 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 & templatesNhững tính năng mà các lựa chọn miễn phí không có.
Kết nối, ngắt kết nối và kiểm tra tín hiệu giữa các node. Không đối thủ nào hỗ trợ điều này. Thiết yếu cho kiến trúc hướng sự kiện của Godot.
Mọi thay đổi đều đi qua hệ thống UndoRedo của Godot. Ctrl+Z mọi thứ AI làm. Các lựa chọn miễn phí sửa cảnh trực tiếp mà không có hoàn tác.
Vector2(100,200), #ff0000, Color(1,0,0) — AI gửi chuỗi, chúng tôi tự động phân tích chúng thành các kiểu Godot đúng chuẩn.
WebSocket với heartbeat, tự động kết nối lại (exponential backoff) và tự động quét cổng. Không rớt kết nối, không cần khởi động lại thủ công.
Lỗi bao gồm mã có cấu trúc và gợi ý khả thi. AI có thể tự sửa thay vì mắc kẹt với các thất bại khó hiểu.
11 công cụ node: thêm, xóa, đổi tên, nhân bản, di chuyển/đổi cha, cập nhật thuộc tính, thêm tài nguyên, đặt anchor. Không đối thủ nào bao phủ hết những thao tác này.
Hãy để AI chơi game của bạn. Mô phỏng bàn phím, chuột và InputAction. Ghi lại các phiên input và phát lại để kiểm thử hồi quy với thời gian chính xác đến từng khung hình.
15 công cụ để kiểm tra game trực tiếp. Đọc và sửa thuộc tính trong runtime, chụp khung hình, giám sát thay đổi thuộc tính, tìm phần tử UI, nhấp nút theo văn bản và chờ node xuất hiện.
Tạo hoạt ảnh, thêm track, chèn keyframe. Xây dựng máy trạng thái với chuyển tiếp và điều kiện. Cấu hình blend tree với các node Add2, Blend2 và TimeScale.
Thêm mesh (nguyên thủy hoặc .glb/.gltf), thiết lập ánh sáng với preset, cấu hình vật liệu PBR, tạo môi trường với sky/fog/SSAO/SSR, đặt camera và dựng GridMap.
Thiết lập hình dạng va chạm, cấu hình physics body, quản lý lớp va chạm, thêm raycast. Tạo vùng điều hướng, bake nav mesh, cấu hình agent tìm đường.
Tạo hệ thống hạt GPU với preset (lửa, khói, mưa, tuyết). Quản lý audio bus, thêm hiệu ứng (reverb, delay, compressor) và đặt audio player 2D/3D.
Tạo shader từ mẫu, chỉnh sửa mã GLSL, gán ShaderMaterial và tinh chỉnh uniform trong runtime. Toàn bộ quy trình shader mà không cần rời khỏi cuộc trò chuyện AI.
Chạy các kịch bản kiểm thử tự động với mô phỏng input và kiểm chứng. Xác minh văn bản UI trên màn hình. Stress test với fuzzing input ngẫu nhiên. Tạo báo cáo kiểm thử đạt/không đạt.
Tìm tài nguyên không dùng, lập bản đồ luồng tín hiệu, phân tích độ phức tạp của cảnh, phát hiện phụ thuộc vòng, tìm tham chiếu script và lấy thống kê đầy đủ của dự án.
Tìm node theo kiểu, kiểm tra kết nối tín hiệu, đặt thuộc tính hàng loạt trên nhiều cảnh, tìm kiếm trên tất cả tệp dự án và phân tích phụ thuộc. Tái cấu trúc ở quy mô lớn.
Những ví dụ thực tế về những gì bạn có thể yêu cầu trợ lý AI làm — và nó hoạt động ngay.
AI tạo cảnh, viết script, kết nối tín hiệu, thiết lập UI và chạy game — tất cả trong một cuộc trò chuyện. Xem video demo.
AI thêm mesh, cấu hình preset ánh sáng, thiết lập vật liệu PBR và tinh chỉnh cài đặt môi trường — tất cả thông qua API trình soạn thảo với hoàn tác/làm lại đầy đủ.
AI khởi chạy game, mô phỏng input bàn phím, chụp ảnh màn hình, kiểm tra thuộc tính node trong runtime và xác minh trạng thái game — cho phép các quy trình QA tự động.
AI đọc output lỗi của trình soạn thảo và lỗi biên dịch script, xác định vấn đề, sửa script để khắc phục và xác minh bản sửa — một vòng phản hồi chặt chẽ mà không cần sao chép-dán thông báo lỗi.
AI tạo hạt GPU, cấu hình hình dạng phát xạ và vận tốc, áp dụng dải màu, hoặc dùng các preset dựng sẵn (lửa, khói, mưa, tuyết, tia lửa) để có kết quả tức thì.
AI tìm kiếm trên tất cả các cảnh, tìm các node khớp và áp dụng thay đổi thuộc tính hàng loạt — những tác vụ tốn hàng phút nhấp chuột thủ công được hoàn thành trong vài giây.
Godot MCP Pro vượt trội so với các lựa chọn khác như thế nào.
| Tính năng | Godot MCP Pro | GDAI MCP ($19) | godot-mcp (free) |
|---|---|---|---|
| Tổng số công cụ | 175 | ~30 | 13 |
| Danh mục | 23 | ~8 | 4 |
| Kết nối | WebSocket + heartbeat | stdio (Python) | Headless CLI |
| Undo/Redo | Yes | Yes | No |
| Quản lý Tín hiệu | Yes | No | No |
| Đổi tên/Nhân bản/Di chuyển Node | Yes | No | No |
| Phân tích Kiểu thông minh | Yes | Limited | No |
| Mô phỏng Input | Key / Mouse / Action / Sequence | Yes (basic) | No |
| Phân tích Runtime | 15 công cụ (cây, thuộc tính, khung hình, UI, ghi lại) | No | No |
| Công cụ Cảnh 3D | Mesh, Lighting, PBR, Environment, Camera | No | No |
| Thiết lập Vật lý | Collision, Layers, Raycasts, Bodies | No | No |
| Hạt | GPU 2D/3D with presets | No | No |
| Điều hướng | Region, Mesh baking, Agent | No | No |
| Âm thanh | Buses, Effects, Players | No | No |
| AnimationTree | State machine, Blend tree | No | No |
| Kiểm thử Tự động | Kịch bản, Kiểm chứng, Stress test | No | No |
| Phân tích Mã | Tài nguyên không dùng, Luồng tín hiệu, Độ phức tạp | No | No |
| Ảnh màn hình | Trình soạn thảo + Game + So sánh trực quan | Yes | No |
Những câu hỏi phổ biến về Godot MCP Pro.
Godot MCP Pro là một máy chủ MCP (Model Context Protocol) cao cấp kết nối các trợ lý AI như Claude, Cursor và Cline trực tiếp với trình soạn thảo Godot 4 qua WebSocket. Nó cung cấp 175 công cụ trên 23 danh mục cho thao tác cảnh, hoạt ảnh, mô hình 3D, thiết lập vật lý, hiệu ứng hạt, quản lý âm thanh, chỉnh sửa shader, mô phỏng input, phân tích runtime và kiểm thử tự động.
Cài plugin Godot MCP Pro vào dự án của bạn, bật nó trong Project Settings > Plugins, build máy chủ MCP với npm install && npm run build, và thêm nó vào .mcp.json của bạn. Claude (Code hoặc Desktop) sẽ tự động kết nối với trình soạn thảo Godot qua WebSocket và có quyền truy cập tất cả 175 công cụ.
Bất kỳ AI client tương thích MCP nào đều hoạt động, bao gồm Claude Code, Claude Desktop, Cursor, VS Code với extension Cline, Windsurf và các công cụ khác hỗ trợ chuẩn Model Context Protocol. Giao thức MCP là một chuẩn mở, vì vậy các client mới được bổ sung thường xuyên.
Có. Godot MCP Pro bao gồm các công cụ 3D chuyên dụng để thêm mesh nguyên thủy hoặc nhập mô hình .glb/.gltf, thiết lập ánh sáng với preset, cấu hình vật liệu PBR, tạo môi trường với sky/fog/SSAO/SSR, đặt camera và dựng GridMap. Kết hợp với các công cụ vật lý, điều hướng và hạt, AI có thể xây dựng các cảnh game 3D hoàn chỉnh.
Có. Bộ phân tích runtime bao gồm 15 công cụ cho phép AI khởi chạy game của bạn, mô phỏng input bàn phím/chuột/action, chụp ảnh màn hình, kiểm tra cây cảnh trực tiếp, đọc và sửa thuộc tính trong runtime, ghi lại và phát lại các phiên input, tìm phần tử UI, nhấp nút theo văn bản và chạy các kịch bản kiểm thử tự động với kiểm chứng.
Có. Godot MCP Pro hoạt động với Cursor, VS Code + Cline, Windsurf, Claude Code CLI, Claude Desktop và bất kỳ client tương thích MCP nào khác. Cấu hình máy chủ MCP trong cài đặt của trình soạn thảo và nó sẽ kết nối qua WebSocket.
Godot 4.4 trở lên (đã kiểm thử trên Godot 4.6) và Node.js 18+. Hoạt động trên Windows, macOS và Linux.
Godot MCP Pro cung cấp 175 công cụ so với 13-32 ở các lựa chọn miễn phí. Các tính năng độc quyền bao gồm hoàn tác/làm lại đầy đủ, quản lý tín hiệu, mô phỏng input với ghi lại/phát lại, bộ phân tích runtime 15 công cụ, dựng cảnh 3D, thiết lập vật lý, hệ thống hạt, quản lý audio bus, công cụ nav mesh, máy trạng thái AnimationTree, kiểm thử tự động và phân tích mã.
Có. Plugin trình soạn thảo GDScript (addons/godot_mcp/) hoàn toàn mã nguồn mở và có sẵn trên GitHub. Bạn có thể kiểm tra chính xác cách plugin giao tiếp với trình soạn thảo trước khi mua. Máy chủ MCP (TypeScript) được bao gồm trong bản tải trả phí.
Không. Godot MCP Pro là một lần mua $15 với cập nhật trọn đời, dự án không giới hạn, máy không giới hạn và hỗ trợ Discord. Không phí định kỳ, không giới hạn số ghế.
Sẵn sàng chạy trong chưa đầy 5 phút.
Sao chép thư mục addons/godot_mcp/ từ bản tải vào thư mục gốc của dự án Godot. Sau đó bật plugin:
Project > Project Settings > Plugins > Godot MCP Pro > Enable
Mở một terminal trong thư mục server/:
cd server npm install npm run build
Thêm máy chủ vào tệp cấu hình MCP của AI client (ví dụ, .mcp.json cho Claude Code):
{
"mcpServers": {
"godot-mcp-pro": {
"command": "node",
"args": ["/path/to/server/build/index.js"]
}
}
}
Mở dự án Godot của bạn với plugin đã được bật. Bảng trạng thái trong dock của trình soạn thảo hiển thị trạng thái kết nối. Khởi động trợ lý AI của bạn và bắt đầu xây dựng — giờ nó có quyền truy cập trực tiếp vào 175 công cụ trong trình soạn thảo Godot của bạn.
Trả một lần, dùng mãi mãi. Đã bao gồm cập nhật trọn đời.