Godot Engine 排名第一的 MCP 伺服器

用 AI 超能力
開發 Godot 遊戲

Godot MCP Pro 是一個擁有 187 個工具的 MCP 伺服器，透過 WebSocket 將 Claude、Cursor 等 AI 助手直接連接到 Godot 4 編輯器。AI 可以建立場景、撰寫 GDScript、模擬玩家輸入、檢查執行中的遊戲、建構 3D 環境、設定物理、管理粒子與音訊——全部在一次對話中完成。$15 一次性購買，支援 Windows、macOS 與 Linux。

在 itch.io 購買 Buy Me a Coffee
$15 一次性購買 · 終身更新

實際示範

一個提示 → AI 建構完整的黑白棋遊戲，啟動並用滑鼠點擊進行測試。

在 YouTube 觀看完整示範 → 
AI Assistant <--stdio/MCP--> Node.js Server <--WebSocket--> Godot Editor

即時雙向通訊。無檔案輪詢。無 CLI 子程序。即時回饋。

指南與教學

AI 驅動的 Godot 4 實用指南。沒有過時的 Godot 3 資訊——所有內容均在 Godot 4.4+ 上測試通過。

⚡

將 AI 連接到 Godot 4

5 分鐘內設定好 MCP Pro，讓 Claude 或 Cursor 直接控制你的 Godot 編輯器。安裝外掛、建構伺服器、設定 AI 客戶端——即刻開始。

"取得專案資訊並顯示場景樹"
入門 ~5 min
使用： get_project_info get_scene_tree
🎮

從零開始建構 2D 遊戲

讓 AI 建立一個完整的 2D 遊戲——場景、腳本、訊號、UI。本指南示範在一次 AI 對話中建構一個黑白棋遊戲，從空專案到可玩遊戲。

"建立一個黑白棋遊戲，8x8 棋盤、點擊落子、AI 對手與分數顯示"
入門 ~15 min
使用： create_scene add_node create_script connect_signal play_scene
🧑

3D 角色控制器

建構帶 Mixamo 動畫、AnimationTree 狀態機、SpringArm3D 攝影機與地形的第三人稱角色控制器——全部由 AI 建立。涵蓋 Godot 4 中的 CharacterBody3D、物理層與動畫混合。

"建立一個帶地形的 3D 場景，使用 x_bot.fbx 角色並帶有行走/奔跑/跳躍動畫，以及跟隨攝影機"
進階 ~20 min
使用： add_mesh_instance setup_lighting create_animation_tree setup_physics_body setup_camera_3d
🔌

Godot 4 訊號模式

Godot 4 徹底改造了訊號系統。不再使用 connect("signal", obj, "method")——改用 signal.connect(callable)。讓 AI 審查你的訊號架構、找出未連接的訊號，並將整個專案的訊號流視覺化。

"分析我專案中的訊號流並找出未連接的訊號"
進階 ~10 min
使用： analyze_signal_flow find_signal_connections get_signals connect_signal
🤖

自動化遊戲測試

讓 AI 測試你的遊戲。啟動遊戲、模擬鍵盤/滑鼠輸入、擷取螢幕截圖、驗證遊戲狀態，並執行隨機輸入的壓力測試。無需測試框架——MCP Pro 在編輯器層面完成一切。

"啟動遊戲，向右走 2 秒，跳躍，然後驗證玩家是否到達了平台"
進階 ~10 min
使用： play_scene simulate_key capture_frames assert_node_state run_stress_test
🎬

AnimationTree 狀態機

Godot 4 的 AnimationTree 功能強大但複雜。讓 AI 建立帶轉場與條件的狀態機、設定混合樹、設定參數——Godot 初學者最常遇到的難題，幾分鐘內解決。

"建立一個包含 Idle、Walk、Run 與 Jump 狀態的 AnimationTree，並設定正確的轉場"
高級 ~15 min
使用： create_animation_tree add_state_machine_state add_state_machine_transition set_tree_parameter
💥

物理與碰撞設定

Godot 4 將 PhysicsBody 重新命名為 CharacterBody/RigidBody，並變更了碰撞層 API。讓 AI 設定碰撞形狀、正確設定物理層、新增射線偵測，並審查碰撞設定——避免最常見的物理 Bug。

"為所有 CharacterBody2D 節點設定碰撞，並按類型（player、enemy、environment）組織物理層"
進階 ~10 min
使用： setup_collision set_physics_layers setup_physics_body get_collision_info
✨

粒子效果手冊

Godot 4 將預設粒子從 CPUParticles 替換為 GPUParticles2D/3D。使用內建預設建立火焰、煙霧、雨、雪與火花，或精細調整發射形狀、速度曲線與顏色漸層——全部透過自然語言提示完成。

"為火把新增火焰粒子，使用橙色到紅色的漸層，並套用火焰預設"
入門 ~5 min
使用： create_particles apply_particle_preset set_particle_color_gradient set_particle_material

運作原理

5 分鐘內將 AI 助手連接到 Godot。

安裝外掛

將 addons/godot_mcp/ 複製到你的 Godot 專案中。在 Project > Project Settings > Plugins 中啟用它。外掛會在編輯器內自動啟動 WebSocket 伺服器。

建構 MCP 伺服器

在 server/ 目錄下執行 npm install && npm run build。這會編譯 TypeScript MCP 伺服器，作為 AI 客戶端與 Godot 外掛之間的橋樑。

開始用 AI 建構

將伺服器加入 AI 客戶端的 MCP 設定中。開啟 Godot，你的 AI 助手現在可以即時存取 187 個工具——建立場景、編輯腳本、模擬輸入，以及分析執行中的遊戲。

187
個工具
26
個分類
16
獨有分類
（競品均不具備）
∞
復原/重做
所有異動均支援

187 個工具，26 個分類

AI 在 2D 與 3D 中建構、檢查、測試與修改 Godot 專案所需的一切。

Project

10 tools
  • get_project_info metadata & autoloads
  • get_filesystem_tree recursive file tree
  • search_files fuzzy/glob search
  • get/set_project_settings read & write
  • uid_to_project_path UID conversion
  • project_path_to_uid path conversion
  • search_in_files content search
  • add_autoload remove_autoload

Scene

10 tools
  • get_scene_tree live hierarchy
  • get_scene_file_content raw .tscn
  • create_scene new scenes
  • open_scene delete_scene save_scene
  • add_scene_instance prefab-like instancing
  • play_scene stop_scene
  • get_scene_exports @export overview

Node

17 tools
  • add_node delete_node rename_node
  • duplicate_node deep copy
  • move_node reparent
  • update_property smart type parsing
  • get_node_properties inspect all props
  • add_resource shapes, materials
  • set_anchor_preset UI anchors
  • connect_signal disconnect_signal
  • get/set_node_groups find_nodes_in_group
  • get_editor_selection select_nodes clear_editor_selection

Script

9 tools
  • list_scripts project-wide overview
  • read_script create_script
  • edit_script search/replace & insert
  • attach_script attach to nodes
  • get_open_scripts editor awareness
  • validate_script syntax check
  • close_script reload_open_scripts (Godot 4.7+) NEW

Editor

15 tools
  • get_editor_errors errors & stack traces
  • get_editor_screenshot editor viewport
  • get_game_screenshot running game
  • compare_screenshots visual diff
  • execute_editor_script run GDScript
  • get_signals inspect signal connections
  • reload_plugin reload_project
  • clear_output
  • get_output_log output panel
  • get/set_editor_camera frame 3D views
  • set_auto_dismiss auto-close blocking dialogs
  • get_unsaved_state save_all unsaved-change check & save NEW

Input Simulation

5 tools
  • simulate_key keyboard with modifiers
  • simulate_mouse_click positioned clicks
  • simulate_mouse_move absolute/relative
  • simulate_action Godot InputActions
  • simulate_sequence multi-event combos

Input Map

2 tools
  • get_input_actions list actions & events
  • set_input_action create/modify actions

Runtime Analysis

20 tools
  • get_game_scene_tree live game hierarchy
  • get/set_game_node_properties runtime inspection & tweaking
  • execute_game_script run code in live game
  • capture_frames multi-frame screenshots
  • monitor_properties property timeline
  • start/stop/replay_recording input recording & replay
  • find_nodes_by_script get_autoload
  • find_ui_elements click_button_by_text
  • wait_for_node batch_get_properties
  • record_frames long captures to disk
  • watch_signals signal emission log
  • find_nearby_nodes navigate_to move_to

Animation

6 tools
  • list_animations create_animation
  • add_animation_track value/position/bezier
  • set_animation_keyframe insert keys
  • get_animation_info tracks & keyframes
  • remove_animation

AnimationTree

9 tools
  • create_animation_tree with state machine root
  • get_animation_tree_structure full tree inspection
  • add/remove_state_machine_state manage states
  • add/remove_state_machine_transition with conditions
  • set_blend_tree_node Add2, Blend2, TimeScale
  • set_tree_parameter conditions & blends
  • setup_ik_modifier IK chains on Skeleton3D (Godot 4.6+) NEW

TileMap

6 tools
  • tilemap_set_cell place tiles
  • tilemap_fill_rect fill regions
  • tilemap_get_cell read tile data
  • tilemap_clear clear all
  • tilemap_get_info tile set sources
  • tilemap_get_used_cells query used cells

3D Scene

7 tools
  • add_mesh_instance primitives & .glb/.gltf import
  • setup_lighting sun/indoor/dramatic presets
  • set_material_3d full PBR material setup
  • setup_environment sky, fog, glow, SSAO, SSR
  • setup_camera_3d projection, FOV, cull mask
  • add_gridmap GridMap with MeshLibrary
  • get_gridmap_info GridMap bounds & item counts NEW

Physics

6 tools
  • setup_collision auto-detect 2D/3D shapes
  • set/get_physics_layers layer & mask management
  • add_raycast RayCast2D/3D
  • setup_physics_body CharacterBody & RigidBody config
  • get_collision_info full collision audit

Particles

5 tools
  • create_particles GPUParticles 2D/3D
  • set_particle_material direction, velocity, emission shape
  • set_particle_color_gradient color ramp stops
  • apply_particle_preset fire, smoke, rain, snow, sparks
  • get_particle_info full config inspection

Navigation

5 tools
  • setup_navigation_region auto-detect 2D/3D
  • bake_navigation_mesh mesh baking & polygon gen
  • setup_navigation_agent pathfinding & avoidance
  • set_navigation_layers layer management
  • get_navigation_info full nav audit

Audio

6 tools
  • get_audio_bus_layout full bus overview
  • add_audio_bus set_audio_bus create & configure
  • add_audio_bus_effect reverb, delay, compressor, EQ
  • add_audio_player 2D/3D audio players
  • get_audio_info subtree audio audit

Theme & UI

8 tools
  • create_theme new Theme resource
  • set_theme_color color overrides
  • set_theme_constant constant overrides
  • set_theme_font_size font sizes
  • set_theme_stylebox StyleBoxFlat
  • get_theme_info inspect overrides
  • setup_control Control layout in one call
  • add_virtual_joystick touch joystick (Godot 4.7+) NEW

Shader

6 tools
  • create_shader with templates
  • read_shader edit_shader
  • assign_shader_material to nodes
  • set_shader_param set uniforms
  • get_shader_params read all params

Resource

4 tools
  • read_resource inspect .tres properties
  • edit_resource modify & save
  • create_resource new .tres of any type
  • get_resource_preview thumbnails

Batch & Refactoring

7 tools
  • find_nodes_by_type search by class
  • find_signal_connections audit signals
  • batch_set_property bulk changes
  • find_node_references cross-file search
  • get_scene_dependencies dependency graph
  • cross_scene_set_property project-wide changes
  • batch_add_nodes build node trees in one call

Testing & QA

6 tools
  • run_test_scenario automated test sequences
  • assert_node_state property assertions
  • assert_screen_text UI text verification
  • run_stress_test random input fuzzing
  • get_test_report pass/fail summary
  • set_game_speed slow motion / fast-forward NEW

Code Analysis

6 tools
  • find_unused_resources dead asset detection
  • analyze_signal_flow signal graph mapping
  • analyze_scene_complexity node count & depth
  • find_script_references cross-project search
  • detect_circular_dependencies cycle detection
  • get_project_statistics full project overview

Profiling

2 tools
  • get_performance_monitors FPS, memory, physics
  • get_editor_performance quick summary

Export

4 tools
  • list_export_presets configured presets
  • export_project build commands
  • get_export_info paths & templates
  • export_patch_pck patch PCKs NEW

Headless

3 tools
  • run_headless_scene run test suites in a separate process
  • run_headless_script --script probes
  • get_godot_executable binary & project path

Android

3 tools
  • list_android_devices adb devices
  • get_android_preset_info preset metadata
  • deploy_to_android export, install & launch

為什麼選擇 Pro？

免費替代品所沒有的功能。

訊號管理

連接、斷開與檢查節點間的訊號。競品均不支援此功能。對 Godot 的事件驅動架構至關重要。

完整的復原/重做

所有異動都透過 Godot 的 UndoRedo 系統進行。Ctrl+Z 可復原 AI 的一切操作。免費替代品直接修改場景，無法復原。

智慧型別解析

Vector2(100,200)、#ff0000、Color(1,0,0)——AI 送出字串，我們自動將其解析為正確的 Godot 型別。

正式環境級連線

WebSocket 連線，帶心跳偵測、自動重新連線（指數退避）與連接埠自動掃描。不會斷線，無需手動重新啟動。

情境式錯誤建議

錯誤訊息包含結構化代碼與可操作建議。AI 可以自行修正，而不是被晦澀的錯誤訊息卡住。

完整的節點操作

11 個節點工具：新增、刪除、重新命名、複製、移動/重新掛載、更新屬性、新增資源、設定錨點。競品均無法涵蓋所有這些。

輸入模擬與錄製

讓 AI 玩你的遊戲。模擬鍵盤、滑鼠與 InputActions。錄製輸入工作階段並回放，用於精確到影格的迴歸測試。

執行階段分析

20 個工具用於即時遊戲檢查。在執行階段讀取與修改屬性、擷取影格、監控屬性變化、尋找 UI 元素、按文字點擊按鈕，以及等待節點出現。

動畫與 AnimationTree

建立動畫、新增軌道、插入關鍵影格。建構帶轉場與條件的狀態機。設定包含 Add2、Blend2 與 TimeScale 節點的混合樹。

3D 場景建構

新增網格（基本體或 .glb/.gltf）、使用預設設定燈光、設定 PBR 材質、建立含天空/霧/SSAO/SSR 的環境、放置攝影機，以及建構 GridMap。

物理與導航

設定碰撞形狀、設定物理體、管理碰撞層、新增射線偵測。建立導航區域、烘焙導航網格、設定尋路代理。

粒子與音訊

使用預設（火焰、煙霧、雨、雪）建立 GPU 粒子系統。管理音訊匯流排、新增效果（殘響、延遲、壓縮器），放置 2D/3D 音訊播放器。

著色器工作流程

從範本建立著色器、編輯 GLSL 程式碼、指派 ShaderMaterial，並在執行階段調整 uniform 變數。無需離開 AI 聊天即可完成完整的著色器工作流程。

測試與 QA

執行帶輸入模擬與斷言的自動化測試情境。驗證螢幕上的 UI 文字。使用隨機輸入進行壓力測試。產生通過/失敗測試報告。

程式碼分析

尋找未使用的資源、對應訊號流、分析場景複雜度、偵測循環相依、搜尋腳本參照，以及取得完整的專案統計資訊。

批次操作

按類型尋找節點、審查訊號連接、跨場景批次設定屬性、搜尋所有專案檔案，以及分析相依性。大規模重構。

AI 能在你的 Godot 專案中做什麼？

真實範例——你可以讓 AI 助手執行這些操作，而且它能直接完成。

從零建構完整遊戲

"建立一個黑白棋遊戲，8x8 棋盤、點擊落子、AI 對手與分數顯示。"

AI 建立場景、撰寫腳本、連接訊號、設定 UI 並執行遊戲——全部在一次對話中完成。觀看示範影片。

使用： create_scene add_node create_script connect_signal play_scene

設定 3D 環境

"新增地形網格，設定帶陰影的戲劇性燈光，設定 roughness 為 0.3 的 PBR 材質，並新增 volumetric density 為 0.02 的霧。"

AI 新增網格、設定燈光預設、設定 PBR 材質並調整環境參數——全部透過編輯器 API 完成，支援完整的復原/重做。

使用： add_mesh_instance setup_lighting set_material_3d setup_environment

自動化遊戲測試

"啟動遊戲，讓角色向右走 2 秒，跳躍，然後檢查玩家是否到達了平台。"

AI 啟動遊戲、模擬鍵盤輸入、擷取螢幕截圖、檢查執行階段節點屬性並驗證遊戲狀態——實現自動化 QA 工作流程。

使用： play_scene simulate_key get_game_screenshot get_game_node_properties assert_node_state

偵錯 GDScript 錯誤

"檢查編輯器中的錯誤並修復它們。"

AI 讀取編輯器的錯誤輸出與腳本編譯錯誤，定位問題，編輯腳本進行修復並驗證——緊密的回饋循環，無需複製貼上錯誤訊息。

使用： get_editor_errors read_script edit_script get_editor_errors

新增粒子效果

"為火把節點新增火焰粒子，使用橙色到紅色的漸層與向上的速度。"

AI 建立 GPU 粒子、設定發射形狀與速度、套用顏色漸層，或使用內建預設（火焰、煙霧、雨、雪、火花）即時呈現效果。

使用： create_particles set_particle_material set_particle_color_gradient

跨場景重構

"找出專案中所有 CharacterBody2D 節點，並將它們的 floor_snap_length 設定為 8。"

AI 搜尋所有場景、找出相符的節點並批次修改屬性——手動點擊需要幾分鐘的任務，幾秒鐘就完成了。

使用： find_nodes_by_type batch_set_property cross_scene_set_property

比較

Godot MCP Pro 與替代方案的比較。

功能 Godot MCP Pro GDAI MCP ($19) godot-mcp (free)
工具總數187~3013
分類26~84
連線方式WebSocket + heartbeatstdio (Python)Headless CLI
Undo/RedoYesYesNo
訊號管理YesNoNo
節點重新命名/複製/移動YesNoNo
智慧型別解析YesLimitedNo
輸入模擬Key / Mouse / Action / SequenceYes (basic)No
執行階段分析20 個工具（場景樹、屬性、影格、UI、錄製）NoNo
3D 場景工具Mesh, Lighting, PBR, Environment, CameraNoNo
物理設定Collision, Layers, Raycasts, BodiesNoNo
粒子GPU 2D/3D with presetsNoNo
導航Region, Mesh baking, AgentNoNo
音訊Buses, Effects, PlayersNoNo
AnimationTreeState machine, Blend treeNoNo
自動化測試情境測試、斷言、壓力測試NoNo
程式碼分析未使用資源、訊號流、複雜度NoNo
螢幕截圖編輯器 + 遊戲 + 視覺差異比對YesNo

查看完整比較與選購指南 →

常見問題

關於 Godot MCP Pro 的常見問題。

什麼是 Godot MCP Pro？

Godot MCP Pro 是一個進階 MCP（Model Context Protocol）伺服器，透過 WebSocket 將 Claude、Cursor 與 Cline 等 AI 助手直接連接到 Godot 4 編輯器。它提供 26 個分類共 187 個工具，用於場景操作、動畫、3D 建模、物理設定、粒子效果、音訊管理、著色器編輯、輸入模擬、執行階段分析與自動化測試。

如何將 Claude 連接到 Godot？

在專案中安裝 Godot MCP Pro 外掛，在 Project Settings > Plugins 中啟用，使用 npm install && npm run build 建構 MCP 伺服器，然後加入 .mcp.json 中。Claude（Code 或 Desktop）將自動透過 WebSocket 連接到 Godot 編輯器並取得所有 187 個工具的存取權限。

哪些 AI 助手支援 Godot MCP Pro？

任何相容 MCP 的 AI 客戶端都可以使用，包括 Claude Code、Claude Desktop、Cursor、VS Code 搭配 Cline 擴充功能、Windsurf，以及其他支援 Model Context Protocol 標準的工具。MCP 協定是開放標準，新客戶端持續增加中。

AI 能在 Godot 中建構 3D 遊戲嗎？

可以。Godot MCP Pro 包含專用的 3D 工具，可以新增基本體網格或匯入 .glb/.gltf 模型、使用預設設定燈光、設定 PBR 材質、建立含天空/霧/SSAO/SSR 的環境、放置攝影機，以及建構 GridMap。結合物理、導航與粒子工具，AI 可以建構完整的 3D 遊戲場景。

AI 能測試我的遊戲嗎？

可以。執行階段分析套件包含 20 個工具，讓 AI 可以啟動遊戲、模擬鍵盤/滑鼠/動作輸入、擷取螢幕截圖、檢查即時場景樹、讀取與修改執行階段屬性、錄製與回放輸入工作階段、尋找 UI 元素、按文字點擊按鈕，以及執行帶斷言的自動化測試情境。

支援 Cursor 嗎？

支援。Godot MCP Pro 可與 Cursor、VS Code + Cline、Windsurf、Claude Code CLI、Claude Desktop 以及任何其他相容 MCP 的客戶端搭配使用。在編輯器設定中設定 MCP 伺服器即可透過 WebSocket 連線。

需要什麼版本的 Godot？

Godot 4.4 或更新版本（已在 Godot 4.4/4.5/4.6/4.7 上測試）以及 Node.js 18+。支援 Windows、macOS 與 Linux。

與免費替代品相比如何？

Godot MCP Pro 提供 187 個工具，而免費替代品僅有 13-32 個。獨有功能包括：完整的復原/重做、訊號管理、帶錄製/回放的輸入模擬、20 個工具的執行階段分析套件、3D 場景建構、物理設定、粒子系統、音訊匯流排管理、導航網格工具、AnimationTree 狀態機、自動化測試與程式碼分析。

外掛原始碼是否開放？

是的。GDScript 編輯器外掛（addons/godot_mcp/）完全開放原始碼，可在 GitHub 上查看。你可以在購買前查看外掛如何與編輯器通訊。MCP 伺服器（TypeScript）包含在付費下載中。

需要訂閱嗎？

不需要。Godot MCP Pro 是 $15 一次性購買，包含終身更新、不限專案數、不限機器數，以及 Discord 支援。沒有經常性費用，沒有席次限制。

快速設定指南

5 分鐘內完成設定。

1. 安裝 Godot 外掛

將下載包中的 addons/godot_mcp/ 資料夾複製到 Godot 專案的根目錄。然後啟用外掛：

Project > Project Settings > Plugins > Godot MCP Pro > Enable

2. 建構 MCP 伺服器

在 server/ 目錄下開啟終端機：

cd server
npm install
npm run build

3. 設定 AI 客戶端

將伺服器加入 AI 客戶端的 MCP 設定檔中（例如 Claude Code 的 .mcp.json）：

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"]
    }
  }
}

4. 開始使用

開啟已啟用外掛的 Godot 專案。編輯器面板中的狀態面板會顯示連線狀態。啟動 AI 助手並開始建構——它現在可以直接存取 Godot 編輯器中的 187 個工具。

簡單的一次性定價

一次付費，永久使用。包含終身更新。

$15
一次性付款
  • ✓ 26 個分類共 187 個工具
  • ✓ 支援 2D 與 3D
  • ✓ 終身更新
  • ✓ 不限專案數
  • ✓ 不限機器數
  • ✓ Discord 支援頻道
在 itch.io 購買 Buy Me a Coffee 有問題嗎？加入我們的 Discord