Godot MCP Bf0e2f19

MCP运维云端

提供方 tugcantopaloglu

运维云端 未标注 无需鉴权 社区 / 第三方 ClaudeCursorCline

一个全面的模型上下文协议(MCP)服务器,为AI助手提供对Godot游戏引擎的完全控制,包括149种工具,涵盖网络、3D/2D渲染、UI控制、音频效果、动画树、文件I/O、运行时代码执行、属性检查、场景操作、信号管理、物理、项目创建等功能。

一句话选型结论

按资料字段整理

Godot MCP Bf0e2f19 属于运维云端类 MCP 服务器,传输方式未标注,无需鉴权,可直接接入 Claude、Cursor、Cline,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 185 仓库热度,无公开仓库时显示未标注
工具数 149 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量149暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

游戏开发JavaScript本地部署AI控制Godot引擎运行时操作自动化工具

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 149 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 149 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude、Cursor、Cline,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Godot MCP Bf0e2f19当前 149 未标注 未标注 无 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方tugcantopaloglu上游标注的维护方 tugcantopaloglu
分类运维云端本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

31.9 KB
来自项目仓库与上游目录的原文,未做删改

Godot MCP - Full Control

A comprehensive Model Context Protocol (MCP) server that gives AI assistants full control over the Godot game engine. 157 tools spanning networking, 3D/2D rendering, UI controls, audio effects, animation trees, file I/O, runtime code execution, property inspection, scene manipulation, signal management, physics, project creation, and more.

Acknowledgments

This project is built upon and extends godot-mcp by Solomon Elias (Coding-Solo). The original project provided the foundational architecture including the TypeScript MCP server, headless GDScript operations system, and TCP-based runtime interaction server. Thank you for making this possible with your excellent open-source work!

What's New (Improvements Over Original)

The original godot-mcp provided 20 tools for basic project management and scene creation. This fork extends it to 157 tools with the following major additions:

New in 3.1

  • validate_script autoload resolution - Script validation now compiles the target through a SceneTree at _initialize() (after project autoloads are registered) instead of --check-only at _init(). References to autoload singletons no longer produce false Identifier not found errors, while real syntax/type errors are still caught. Verified building a full game whose scripts reference several autoloads.
  • manage_input_map event merging - Adding a second key to an existing input action now merges it into that action's events array (with physical_keycode de-duplication) instead of writing a duplicate actionname= line, which previously left project.godot malformed and silently dropped earlier bindings.

New in 3.0

  • .NET / C# support - Scaffold C# projects and generate C# scripts (create_project with dotnet: true, create_csharp_script); the .csproj SDK version is matched to your installed Godot.
  • GDScript diagnostics - Validate scripts for syntax and type errors without running the game (validate_script, and validate_scripts for all git-changed or project-wide files).
  • Correctness and robustness fixes across the headless scene operations and the runtime interaction server (resource-typed properties now persist, reparenting works, runtime commands are correlated by request id, and the tools survive projects with warnings-as-errors). Requires Godot 4.4 or later; tested and working with the latest Godot 4.7.

Runtime Code Execution

  • game_eval - Execute arbitrary GDScript code in the running game with return values
  • Full await support for async GDScript code
  • Works even when the game is paused (PROCESS_MODE_ALWAYS)

Runtime Node Inspection & Manipulation

  • game_get_property / game_set_property - Read/write any property on any node by path
  • game_call_method - Call any method on any node with arguments
  • game_get_node_info - Full node introspection: properties, signals, methods, children
  • game_instantiate_scene - Dynamically add scenes to the running game
  • game_remove_node - Remove nodes at runtime
  • game_change_scene - Switch scenes at runtime
  • game_reparent_node - Move nodes between parents

Signal System

  • game_connect_signal - Wire up signal connections at runtime
  • game_disconnect_signal - Remove signal connections
  • game_emit_signal - Emit signals with arguments

Animation & Tweening

  • game_play_animation - Control AnimationPlayer (play, stop, pause, list)
  • game_tween_property - Smooth property animation with configurable easing

Game Control & Debugging

  • game_pause - Pause/unpause the game
  • game_performance - FPS, frame time, memory, object counts, draw calls
  • game_wait - Wait N frames (timing-sensitive operations)
  • game_get_nodes_in_group - Query nodes by group
  • game_find_nodes_by_class - Find all nodes of a specific class

Headless Scene Operations (No Running Game Needed)

  • read_scene - Parse any .tscn file and get full node tree with properties as JSON
  • modify_scene_node - Change node properties in scene files
  • remove_scene_node - Remove nodes from scene files
  • attach_script - Attach GDScript files to nodes in scenes
  • create_resource - Create .tres resource files (materials, themes, etc.)

Project Management

  • read_project_settings - Parse project.godot as structured JSON
  • modify_project_settings - Change project settings programmatically
  • list_project_files - List and filter project files by extension

File I/O

  • read_file / write_file / delete_file - Full file system access within Godot projects
  • create_directory - Create directory structures for scripts, scenes, assets

Error & Log Capture

  • game_get_errors - Get new push_error/push_warning messages since last call
  • game_get_logs - Get new print output from the running game since last call

Enhanced Input

  • game_key_hold / game_key_release - Hold keys down for movement testing (WASD etc.)
  • game_scroll - Mouse scroll wheel events
  • game_mouse_drag - Drag between two points over multiple frames
  • game_gamepad - Gamepad button and axis input events

Project Creation & Configuration

  • create_project - Create a new Godot project from scratch (pass dotnet: true to scaffold a .NET/C# project)
  • create_csharp_script - Create a C# script in a Godot .NET project
  • manage_autoloads - Add, remove, or list autoloads
  • manage_input_map - Add, remove, or list input actions and key bindings
  • manage_export_presets - Create or modify export preset configuration

.NET / C# Support

  • create_project with dotnet: true - Scaffold a Godot .NET project (.csproj with Godot.NET.Sdk matched to your Godot version, plus the "C#" feature flag)
  • create_csharp_script - Generate an idiomatic C# script (partial class, correct _Ready/_Process override signatures); the class name is kept in sync with the file name so Godot can attach it
  • get_project_info reports an isDotnet field

GDScript Diagnostics

  • validate_script - Check a single GDScript file for syntax and type errors headlessly, returning { valid, errors: [{ message, file, line }] }
  • validate_scripts - Batch-validate all git-changed .gd files (or the whole project), so an agent can verify its edits before running the game

Camera, Physics & Audio

  • game_get_camera / game_set_camera - Query and control 2D/3D cameras
  • game_raycast - Cast physics rays (auto-detects 2D vs 3D)
  • game_get_audio - Get audio bus layout and playing streams
  • game_spawn_node - Create any node type at runtime with properties
  • game_set_shader_param - Set shader parameters on materials
  • game_audio_play / game_audio_bus - Full audio playback and bus control
  • game_navigate_path - Query navigation paths (2D/3D)
  • game_tilemap - Get/set TileMapLayer cells
  • game_add_collision - Add collision shapes to physics bodies
  • game_environment - Configure post-processing (fog, glow, SSAO, tonemap, etc.)
  • game_manage_group - Add/remove nodes from groups
  • game_create_timer - Create timer nodes programmatically
  • game_set_particles - Configure GPUParticles2D/3D properties and process materials
  • game_create_animation - Create animations with value/method/bezier/audio tracks and keyframes
  • export_project - Trigger headless project export builds (CI/CD ready)
  • game_serialize_state - Save/load entire node tree state as JSON
  • game_physics_body - Configure mass, velocity, damping, friction, bounce
  • game_create_joint - Create physics joints (pin, spring, hinge, cone, slider)
  • game_bone_pose - Get/set skeleton bone poses for character animation
  • game_ui_theme - Apply color, constant, and font size theme overrides
  • game_viewport - Create/configure SubViewport nodes
  • game_debug_draw - Draw debug geometry (lines, spheres, boxes)

Networking

  • game_http_request - HTTP GET/POST/PUT/DELETE with headers and body
  • game_websocket - WebSocket client connect/disconnect/send messages
  • game_multiplayer - ENet multiplayer create server/client/disconnect
  • game_rpc - Call or configure RPC methods on nodes

System & Window Control

  • game_script - Attach, detach, or get source of node scripts at runtime
  • game_window - Get/set window size, fullscreen, title, position
  • game_os_info - Get platform, locale, screen, adapter, memory info
  • game_time_scale - Get/set Engine.time_scale and timing info
  • game_process_mode - Set node process mode (pausable/always/disabled)
  • game_world_settings - Get/set gravity, physics FPS, and world settings

Advanced Signals & Input

  • game_list_signals - List all signals on a node with connections
  • game_await_signal - Await a signal with timeout and return args
  • game_touch - Simulate touch press/release/drag and gestures
  • game_input_state - Query pressed keys, mouse position, connected pads
  • game_input_action - Manage runtime InputMap actions and strength

3D Rendering & Geometry

  • game_csg - Create/configure CSG nodes with boolean operations
  • game_multimesh - Create/configure MultiMeshInstance3D for instancing
  • game_procedural_mesh - Generate meshes via ArrayMesh from vertex data
  • game_light_3d - Create/configure 3D lights (directional/omni/spot)
  • game_mesh_instance - Create MeshInstance3D with primitive meshes
  • game_gridmap - GridMap set/get/clear cells and query used cells
  • game_3d_effects - Create ReflectionProbe, Decal, or FogVolume
  • game_gi - Create/configure VoxelGI or LightmapGI
  • game_path_3d - Create Path3D/Curve3D and manage curve points
  • game_sky - Create/configure Sky with procedural/physical sky
  • game_camera_attributes - Configure DOF, exposure, auto-exposure on camera
  • game_navigation_3d - Create/configure NavigationRegion3D and bake
  • game_physics_3d - Area3D queries and point/shape intersection tests

2D Systems

  • game_canvas - Create/configure CanvasLayer and CanvasModulate
  • game_canvas_draw - 2D drawing: line/rect/circle/polygon/text/clear
  • game_light_2d - Create/configure 2D lights and light occluders
  • game_parallax - Create/configure ParallaxBackground and layers
  • game_shape_2d - Line2D/Polygon2D point manipulation
  • game_path_2d - Path2D/Curve2D management and AnimatedSprite2D
  • game_physics_2d - Area2D queries and 2D point/shape intersections

Advanced Animation

  • game_animation_tree - AnimationTree state machine travel and params
  • game_animation_control - AnimationPlayer seek/queue/speed/info control
  • game_skeleton_ik - SkeletonIK3D start/stop/set target position

Advanced Audio

  • game_audio_effect - Add/remove/configure audio bus effects
  • game_audio_bus_layout - Create/remove/reorder audio buses and routing
  • game_audio_spatial - Configure AudioStreamPlayer3D spatial properties

Editor & Project Tools

  • rename_file - Rename or move a file within the project
  • manage_resource - Read or modify .tres/.res resource files
  • create_script - Create a GDScript file from a template
  • validate_script - Check a GDScript file for syntax/type errors headlessly (no run needed)
  • validate_scripts - Batch-check GDScript files: git-changed ones by default, or all
  • manage_scene_signals - List/add/remove signal connections in .tscn files
  • manage_layers - List/set named layer definitions in project
  • manage_plugins - List/enable/disable editor plugins
  • manage_shader - Create or read .gdshader files
  • manage_theme_resource - Create/read/modify Theme .tres resources
  • set_main_scene - Set the main scene in project.godot
  • manage_scene_structure - Rename/duplicate/move nodes within .tscn scenes
  • game_locale - Set/get locale and translate strings at runtime

UI Controls

  • game_ui_control - Set focus, anchors, tooltip, mouse filter on Control
  • game_ui_text - LineEdit/TextEdit/RichTextLabel text operations
  • game_ui_popup - Show/hide/popup for Popup/Dialog/Window nodes
  • game_ui_tree - Tree control: get/select/collapse/add/remove items
  • game_ui_item_list - ItemList/OptionButton: get/select/add/remove items
  • game_ui_tabs - TabContainer/TabBar: get/set current tab
  • game_ui_menu - PopupMenu/MenuBar: add/remove/get menu items
  • game_ui_range - ProgressBar/Slider/SpinBox/ColorPicker get/set

Rendering & Resources

  • game_render_settings - Get/set MSAA, FXAA, TAA, scaling mode/scale
  • game_resource - Runtime resource load, save, or preload

Robustness Improvements

  • Reentrancy guard - Prevents concurrent command processing during async operations
  • Full type conversion - Supports Vector2/3, Color, Quaternion, Basis, Transform2D/3D, AABB, Rect2, and all packed array types
  • Smart property type detection - Uses node's get_property_list() for automatic type conversion
  • PackedArray serialization - Proper JSON arrays instead of string fallback
  • Graceful error handling - Scene read fallback to raw .tscn text on missing dependencies

All 157 Tools

Project Management (7 tools)

Tool Description
launch_editor Launch Godot editor for a project
run_project Run a Godot project and capture output
stop_project Stop the running project
get_debug_output Get console output and errors
get_godot_version Get installed Godot version
list_projects Find Godot projects in a directory
get_project_info Get project metadata

Scene Management (7 tools)

Tool Description
create_scene Create a new scene with a root node type
add_node Add a node to an existing scene
load_sprite Load a texture into a Sprite2D node
export_mesh_library Export a scene as MeshLibrary
save_scene Save a scene (with optional variant path)
get_uid Get UID for a file (Godot 4.4+)
update_project_uids Resave resources to update UIDs

Headless Scene Operations (5 tools)

Tool Description
read_scene Read full scene tree as JSON
modify_scene_node Modify node properties in a scene file
remove_scene_node Remove a node from a scene file
attach_script Attach a GDScript to a scene node
create_resource Create a .tres resource file

Project Settings (3 tools)

Tool Description
read_project_settings Parse project.godot as JSON
modify_project_settings Change a project setting
list_project_files List/filter project files

Runtime Input (4 tools)

Tool Description
game_screenshot Capture a screenshot (base64 PNG)
game_click Click at a position
game_key_press Send key press or input action
game_mouse_move Move the mouse

Runtime Inspection (3 tools)

Tool Description
game_get_ui Get all visible UI elements
game_get_scene_tree Get full scene tree structure
game_get_node_info Detailed node introspection

Runtime Code Execution (1 tool)

Tool Description
game_eval Execute arbitrary GDScript with return values

Runtime Node Manipulation (7 tools)

Tool Description
game_get_property Get any node property
game_set_property Set any node property (auto type conversion)
game_call_method Call any method on a node
game_instantiate_scene Add a PackedScene to the running tree
game_remove_node Remove a node from the tree
game_change_scene Switch to a different scene
game_reparent_node Move a node to a new parent

Runtime Signals (5 tools)

Tool Description
game_connect_signal Connect a signal to a method
game_disconnect_signal Disconnect a signal
game_emit_signal Emit a signal with arguments
game_list_signals List all signals on a node with connections
game_await_signal Await a signal with timeout and return args

Runtime Animation (2 tools)

Tool Description
game_play_animation Control AnimationPlayer
game_tween_property Tween a property with easing

Runtime Utilities (5 tools)

Tool Description
game_pause Pause/unpause the game
game_performance Get FPS, memory, draw calls
game_wait Wait N frames
game_get_nodes_in_group Query nodes by group
game_find_nodes_by_class Find nodes by class type

File I/O (4 tools)

Tool Description
read_file Read a text file from a Godot project
write_file Create or overwrite a text file
delete_file Delete a file from a project
create_directory Create a directory inside a project

Error & Log Capture (2 tools)

Tool Description
game_get_errors Get new errors/warnings since last call
game_get_logs Get new print output since last call

Enhanced Input (8 tools)

Tool Description
game_key_hold Hold a key down (no auto-release)
game_key_release Release a held key
game_scroll Mouse scroll wheel event
game_mouse_drag Drag between two points over N frames
game_gamepad Gamepad button or axis input
game_touch Simulate touch press/release/drag and gestures
game_input_state Query pressed keys, mouse position, connected pads
game_input_action Manage runtime InputMap actions and strength

Project Creation (5 tools)

Tool Description
create_project Create a new Godot project (supports dotnet: true for C#)
create_csharp_script Create a C# script in a Godot .NET project
manage_autoloads Add, remove, or list autoloads
manage_input_map Add, remove, or list input actions
manage_export_presets Create or modify export presets

Advanced Runtime (24 tools)

Tool Description
game_get_camera Get active camera position/rotation/zoom
game_set_camera Move or rotate the active camera
game_raycast Cast a ray and return collision results
game_get_audio Get audio bus layout and playing streams
game_spawn_node Create a new node of any type at runtime
game_set_shader_param Set a shader parameter on a node's material
game_audio_play Play, stop, or pause an AudioStreamPlayer node
game_audio_bus Set volume, mute, or solo on an audio bus
game_navigate_path Query a navigation path between two points
game_tilemap Get or set cells in a TileMapLayer node
game_add_collision Add a collision shape to a physics body node
game_environment Get or set environment and post-processing settings
game_manage_group Add or remove a node from a group, or list groups
game_create_timer Create a Timer node with configuration
game_set_particles Configure GPUParticles2D/3D node properties
game_create_animation Create an animation with tracks and keyframes
game_serialize_state Save or load node tree state as JSON
game_physics_body Configure physics body properties (mass, velocity)
game_create_joint Create a physics joint between two bodies
game_bone_pose Get or set bone poses on a Skeleton3D node
game_ui_theme Apply theme overrides to a Control node
game_viewport Create or configure a SubViewport node
game_debug_draw Draw debug lines, spheres, or boxes in 3D

Build & Export (1 tool)

Tool Description
export_project Export a Godot project using a preset

Networking (4 tools)

Tool Description
game_http_request HTTP GET/POST/PUT/DELETE with headers and body
game_websocket WebSocket client connect/disconnect/send messages
game_multiplayer ENet multiplayer create server/client/disconnect
game_rpc Call or configure RPC methods on nodes

System & Window (6 tools)

Tool Description
game_script Attach, detach, or get source of node scripts
game_window Get/set window size, fullscreen, title, position
game_os_info Get platform, locale, screen, adapter, memory info
game_time_scale Get/set Engine.time_scale and timing info
game_process_mode Set node process mode (pausable/always/disabled)
game_world_settings Get/set gravity, physics FPS, and world settings

3D Rendering & Geometry (13 tools)

Tool Description
game_csg Create/configure CSG nodes with boolean operations
game_multimesh Create/configure MultiMeshInstance3D for instancing
game_procedural_mesh Generate meshes via ArrayMesh from vertex data
game_light_3d Create/configure 3D lights (directional/omni/spot)
game_mesh_instance Create MeshInstance3D with primitive meshes
game_gridmap GridMap set/get/clear cells and query used cells
game_3d_effects Create ReflectionProbe, Decal, or FogVolume
game_gi Create/configure VoxelGI or LightmapGI
game_path_3d Create Path3D/Curve3D and manage curve points
game_sky Create/configure Sky with procedural/physical sky
game_camera_attributes Configure DOF, exposure, auto-exposure on camera
game_navigation_3d Create/configure NavigationRegion3D and bake
game_physics_3d Area3D queries and point/shape intersection tests

2D Systems (7 tools)

Tool Description
game_canvas Create/configure CanvasLayer and CanvasModulate
game_canvas_draw 2D drawing: line/rect/circle/polygon/text/clear
game_light_2d Create/configure 2D lights and light occluders
game_parallax Create/configure ParallaxBackground and layers
game_shape_2d Line2D/Polygon2D point manipulation
game_path_2d Path2D/Curve2D management and AnimatedSprite2D
game_physics_2d Area2D queries and 2D point/shape intersections

Advanced Animation (3 tools)

Tool Description
game_animation_tree AnimationTree state machine travel and params
game_animation_control AnimationPlayer seek/queue/speed/info control
game_skeleton_ik SkeletonIK3D start/stop/set target position

Advanced Audio (3 tools)

Tool Description
game_audio_effect Add/remove/configure audio bus effects
game_audio_bus_layout Create/remove/reorder audio buses and routing
game_audio_spatial Configure AudioStreamPlayer3D spatial properties

Editor & Project Tools (14 tools)

Tool Description
rename_file Rename or move a file within the project
manage_resource Read or modify .tres/.res resource files
create_script Create a GDScript file from a template
validate_script Check a GDScript file for syntax/type errors (headless)
validate_scripts Batch-check GDScript files (git-changed by default, or all)
manage_scene_signals List/add/remove signal connections in .tscn files
manage_layers List/set named layer definitions in project
manage_plugins List/enable/disable editor plugins
manage_shader Create or read .gdshader files
manage_theme_resource Create/read/modify Theme .tres resources
set_main_scene Set the main scene in project.godot
manage_scene_structure Rename/duplicate/move nodes within .tscn scenes
game_locale Set/get locale and translate strings at runtime

UI Controls (8 tools)

Tool Description
game_ui_control Set focus, anchors, tooltip, mouse filter on Control
game_ui_text LineEdit/TextEdit/RichTextLabel text operations
game_ui_popup Show/hide/popup for Popup/Dialog/Window nodes
game_ui_tree Tree control: get/select/collapse/add/remove items
game_ui_item_list ItemList/OptionButton: get/select/add/remove items
game_ui_tabs TabContainer/TabBar: get/set current tab
game_ui_menu PopupMenu/MenuBar: add/remove/get menu items
game_ui_range ProgressBar/Slider/SpinBox/ColorPicker get/set

Rendering & Resources (2 tools)

Tool Description
game_render_settings Get/set MSAA, FXAA, TAA, scaling mode/scale
game_resource Runtime resource load, save, or preload

Requirements

  • Godot Engine 4.4 or later (the headless operations script and UID features require 4.4+); tested and working with the latest Godot 4.7
  • (Optional) .NET SDK 8.0+ and the Godot .NET (C#) build, only if you use create_project's dotnet: true flag or create_csharp_script
  • Node.js >= 18.0.0
  • An AI assistant that supports MCP (Claude Code, Cline, Cursor, etc.)

Installation```bash

git clone https://github.com/tugcantopaloglu/godot-mcp.git
cd godot-mcp
npm install
npm run build


## Configuration

### Claude Code

Add to your Claude Code MCP settings:```json
{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

Cline (VS Code)

Add to your Cline MCP settings (cline_mcp_settings.json):```json
{
"mcpServers": {
"godot": {
"command": "node",
"args": ["/absolute/path/to/godot-mcp/build/index.js"],
"disabled": false
}
}
}


### Cursor

Create `.cursor/mcp.json` in your project:```json
{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"]
    }
  }
}

Runtime Tools Setup

To use the game_* runtime tools, your Godot project needs the MCP interaction server autoload. Copy build/scripts/mcp_interaction_server.gd to your project and register it as an autoload:

  1. Copy build/scripts/mcp_interaction_server.gd to your project's scripts folder
  2. In Godot: Project > Project Settings > Autoload
  3. Add the script with the name McpInteractionServer

The server listens on 127.0.0.1:9090 and accepts JSON commands over TCP when the game is running.

Environment Variables

Variable Description
GODOT_PATH Path to the Godot executable (overrides auto-detection)
DEBUG Set to "true" for detailed server-side logging
GODOT_MCP_ALLOWED_DIRS Optional. Restrict all project tools, project discovery and export destinations to these roots. Use ; or , on Windows, and : or , on other systems. Existing symbolic links are resolved before checking access. When unset, any project root is allowed.

File and scene paths must stay within their project directory, including paths
under symbolic links. These checks cover MCP tool arguments. Runtime evaluation
and generated scripts run with the Godot process account's permissions, so use a
separate account or container when executing untrusted code.

Runtime log retention

game_get_logs and game_get_errors accept optional cursor and limit
arguments. The default page size is 200 lines, with a maximum of 500. Responses
include nextCursor, hasMore and dropped. Pass nextCursor back to continue
from the same position. Calls without a cursor continue from the previous call.
Each stream retains the newest 2,000 lines, with at most 4,096 characters per line.
If a cursor predates retained output, dropped is true. get_debug_output returns
the retained streams and their starting offsets.

Contributor validation

Development and CI require Node.js 22.12 or later. The server runtime requirement
remains the version specified in package.json.bash npm ci npm test npm audit --audit-level=moderate

CI runs on Node.js 22 and 24 without publishing packages or deploying services.
npm test builds the server first so executable-entry tests use current code.
Tests include real MCP requests over the SDK's in-memory transport, filesystem
boundary checks, symbolic link escapes, project scaffolding, schema validation
and cursor pagination. Running an actual Godot project remains an integration
check that requires an installed engine. Set GODOT_SMOKE_PATH to the full path
of its console executable to enable the temporary-project headless smoke test.
It creates a project, creates and edits a scene, reads it through MCP, and saves
a second scene. The test removes its temporary files afterward.

Architecture

The server uses two communication channels:

  1. Headless CLI - For operations that don't need a running game (scene reading, modification, resource creation). Runs Godot with --headless --script godot_operations.gd.

  2. TCP Socket - For runtime interaction with a running game. The mcp_interaction_server.gd autoload listens on port 9090 and processes JSON commands sent by the TypeScript MCP server.

Source layout

Path Description
src/index.ts MCP server, tool definitions, and all handlers
src/utils.ts Pure utility functions (parameter mapping, validation, error helpers)
src/scripts/godot_operations.gd Headless GDScript operations runner

…(正文过长,页面只展示前面部分,完整内容见仓库)

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Godot MCP Bf0e2f19 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Godot MCP Bf0e2f19 怎么在 Claude、Cursor、Cline 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Godot MCP Bf0e2f19 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Godot MCP Bf0e2f19 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Godot MCP Bf0e2f19 支持哪些客户端?

资料标注支持 Claude、Cursor、Cline;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Godot MCP Bf0e2f19 能提供哪些能力?

资料显示约 149 个工具;能力标签包括 游戏开发、JavaScript、Claude、AI控制。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。