MCP.Market

Godot Enhanced MCP server

by wgt19861219·io.github.wgt19861219/godot-mcp-enhanced·v0.24.0·97 stars
No reviews yet

Enhanced Godot 4.5-4.7 MCP: headless+editor+bridge, secure GDScript sandbox, closed-loop AI dev.

A85/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A85/100

full report

Adoption
Growing

97 stars110 downloads/wk

Reviews

Write one

Nobody has reviewed Godot Enhanced yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Godot Enhanced tools (58, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • android

    Android Deploy 工具。list_devices: adb 设备列表。get_preset_info: 读 export_presets.cfg Android preset。deploy: export APK + adb install + launch(可选)。

  • animation

    查询、控制和编辑动画。查询: list_players, get_info, get_details, get_keyframes。播放: play, stop, seek, blend。编辑: create, delete, update_props, add_track, remove_track, add_keyframe, remove_keyframe, update_keyframe。

  • animation_track

    动画轨道与关键帧操作。轨道: add_track, remove_track。关键帧: add_keyframe, remove_keyframe, update_keyframe。曲线: set_curve。

  • animtree

    查询、控制和编辑 AnimationTree。支持创建节点、添加状态、添加转换、设置混合参数、播放状态、编辑状态属性。

  • asset

    参数化 3D shape 生成（11 shape）+ 路径阵列 + batch + undo + save 预制件。

  • audio

    音频操作。play: 播放（支持 AudioStreamPlayer/2D/3D）。stop: 停止。set_param: 设置参数（volume_db/pitch_scale/bus）。query: 查询播放状态。…

  • audio_play

    Play audio. Supports AudioStreamPlayer/AudioStreamPlayer2D/AudioStreamPlayer3D nodes. …

  • audio_query

    Query audio playback status. …

  • audio_set_param

    Set audio parameters (volume/pitch/bus). …

  • audio_stop

    Stop audio playback. …

  • batch

    批量操作。create_files: 批量创建文件（支持自动验证 .gd）。run_verify: 批量运行 headless 验证场景。diff_scenes: 比较两个场景文件差异。

  • blender

    Blender 程序化建模。action=execute_bpy：AI 写 bpy 片段，headless 跑，自动导 glb 到 res://。

  • collision_overlaywrite action

    Create colored wireframe overlays for all CollisionShape3D nodes. StaticBody=blue, CharacterBody=green, RigidBody=red, Area=yellow. …

  • confirm_and_executewrite action

    Execute a previously blocked tool using a confirmation token. Use this when a tool returns a confirmation_token.

  • cpp

    GDExtension (C++) 脚手架生成。scaffold_gdextension: 在 project_path 下生成完整可编译的 godot-cpp GDExtension 工程骨架（src/类.cpp/.h + register_types + SConstruct + .gdextension + .gitignore + README），不联网/不编译，对齐 godot-cpp 官方 example。

  • csv_to_resources

    CSV→Resource 批量生成。读取 CSV(class_path 指向的 GDScript Resource 类),按 filename_column 列命名,批量生成 .tres 到 output_dir。CSV 行数据走 GDScript FileAccess.get_csv_line(零进脚本字符串,防注入)。output_dir 经 resolveWithinRoot 沙箱(TS pre);filename 白名单(GDScript 正则 + .. 段级拒)。

  • diagnose_physics

    Diagnose physics collision state for a body. Returns velocity, contact points (position/normal), collision shape info, and warns about ConcavePolygonShape3D traps. WARNING: Uses move_and_collide with test_only=true which may have side effects on physics state. …

  • docs

    Query Godot class documentation: get_class_info, search_classes, find_method, get_inheritance.

  • editor

    Editor real-time operations: sync_start (start scene tree listening), sync_stop (stop listening), get_scene_tree (get current snapshot). Requires editor mode with plugin connection.

  • game

    游戏桥接操作。安装/卸载: game_bridge_install, game_bridge_uninstall。查询: game_query (ping, get_tree, find_nodes, get_node_properties, get_performance, get_viewport_info, take_screenshot)。写入: game_write (set_node_property, call_method)。输入: game_input (send_key, send_mouse_click, send_mouse_move, send_text, send_touch, send_drag)。等待: game_wait (wait_for_node, wait_for_property)。监控: monitor_start/stop/poll (属性时间

  • game_design

    游戏设计工具。validate_gdd: 验证游戏设计文档（GDD）markdown 文件。chain_verify: 对结论运行 Chain-of-Verification 自我挑战，评估置信度。

  • godot_get_context

    一次返回会话全景（模式/项目/连接/场景快照/最近调用统计/工具组/推荐 workflow/规则/性能），减少反复探路。headless 模式 scene=null。

  • godot_list_dynamic_routes

    查询 Godot 端已注册但 MCP 侧未定义的工具。需要 Godot 实例连接。

  • godot_list_instances

    列出所有发现的 Godot 实例（id/项目/端口/状态）。需要 GODOT_MCP_MULTI_INSTANCE=true。

  • godot_select_instance

    选择 Godot 实例（id 或 project_path），后续调用路由到该实例。需要 GODOT_MCP_MULTI_INSTANCE=true。

  • ik

    IK 操作。create: 创建 IK 修饰器节点。get: 读取属性。set: 设置参数。list_bones: 列出骨骼。…

  • load_skill

    从本地知识库(GodotPrompter/gd-agentic 等)按关键词检索 SKILL.md。两级检索:name/description 高精度→全文 fallback。返回带来源标注(source/path)和相关性 score 的匹配。缺失库进 missing_libraries 不报错。

  • manage_tools

    动态管理工具组的启用/停用状态。始终可用，不可被禁用。

  • material

    Material and shader operations. Read: read. Write: set_params, create, save, load. Shader: shader_read, shader_write, shader_load_file, shader_save_file, shader_list_templates, shader_apply_template.

  • nav

    导航操作。create_region: 创建 NavigationRegion3D（可选烘焙）。bake_mesh: 烘焙导航网格（耗时较长）。create_agent: 创建 NavigationAgent3D。set_params: 设置导航参数。create_link: 创建 NavigationLink3D。query_path: 查询 3D 导航路径。…

  • nav_query_path

    Query 3D navigation path. …

  • node_create_3dwrite action

    Create 3D node at runtime. Headless-created nodes are not persisted — use add_node + save_scene for persistence. …

  • particles

    创建 GPUParticles2D/3D 节点、设置发射/处理参数、加载预设效果、设置粒子材质。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。…

  • physics

    物理系统统一工具。支持 5 种操作：raycast（3D 射线检测）、body_info（物理体碰撞信息）、

  • physics_body_info

    Get physics body collision info. …

  • physics_raycast

    Perform 3D raycast. …

  • profiler

    性能分析工具。snapshot: 快照（FPS/内存/绘制调用/物理统计）。start/stop: 开始/停止分析会话。get_data: 收集帧级数据，含多维度采样、p99百分位、趋势退化检测、内存趋势、渲染统计。get_active_processes: 遍历场景树查找有 _process/_physics_process 的节点。get_signal_connections: 列出子树所有信号连接。

  • project

    搜索 Godot 项目、获取项目信息、列出文件、读取配置、创建项目、设置项目规则。

  • query_spatial

    Query 3D space for collision bodies within a radius. Returns body paths, types, distances sorted nearest-first. …

  • recording

    录制、保存、加载、回放输入事件（键盘/鼠标）。需要 Game Bridge 连接。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。…

  • runtime

    启动编辑器、运行/停止项目、获取调试输出、运行测试、获取 Godot 版本。

  • scene

    场景操作。读取/创建: read_scene, create_scene, quick_scene。节点: add_node, batch_add_nodes, edit_node, remove_node。保存/资源: save_scene, load_sprite。查询: query_scene_tree, inspect_node。实例: instance_scene, set_instance_property, detach_instance。

  • scene_commit

    批量执行场景修改操作（tile_set/tile_fill/tile_erase/tile_clear/tileset_assign/node_property/node_add），合并为一次 Godot 进程调用。适合需要持久化的批量修改。

  • screenshot

    Screenshot capture and image analysis handoff. capture: capture a Godot scene screenshot in headless mode (experimental). analyze: return the image as MCP image content (base64) for the client vision capability to examine — returns image data, NOT a text description.

  • script

    脚本操作。读写: read_script, write_script。编辑: edit_script（行号/search_and_replace）。执行: execute_gdscript（⚠️ 沙箱仅防误操作，不可用于不可信输入。高安全场景请用 ALLOW_EXECUTE_GDSCRIPT=false 或容器隔离）。测试: generate_test, create_test_scene。批量替换: project_replace。

  • self_updatewrite action

    检查/更新 enhanced 自身。check：查 npm 最新版 + 各项目 addon 版本漂移（只读）。update：更新指定项目 addon 到包版本（覆盖安装，需确认）。

  • signal

    信号操作。connect/disconnect: 连接/断开信号。emit: 发射信号（参数仅基本类型）。list: 列出节点可用信号。…

  • signal_connect

    Connect a signal between two nodes. …

  • signal_disconnect

    Disconnect a signal between two nodes. …

  • signal_emit

    Emit a node signal. Args only support basic types (string/number/bool/null). …

  • signal_list

    List available signals on a node. …

  • spatial_info

    获取 Node3D 空间信息：get_node_info（transform/AABB/visible）、get_bounds（子树合并 AABB）、find_in_aabb（AABB 范围内查找节点）。

  • templates

    代码模板操作。list: 列出可用模板（内置 + 用户自定义），支持按标签或适用类过滤。apply: 将模板应用到指定脚本路径，支持变量替换。

  • tilemap

    TileMap/TileMapLayer 图块操作。读取: tilemap_read, tilemap_copy。写入: tilemap_set_cell, tilemap_erase_cell, tilemap_fill_rect, tilemap_clear, tilemap_paste, tilemap_set_transform。…

  • ui

    UI 操作。节点: ui_create_control, ui_container_add, ui_build_layout。布局: ui_set_layout, ui_get_layout, ui_anchor_preset。主题: ui_set_theme, theme_create, theme_set_property。绘图: ui_draw_recipe。…

  • validation

    运行验证、分析错误、验证项目/脚本、导入资源。一键 headless 运行 + 错误分析，或按需单项检查。

  • verify_delivery

    End-to-end delivery verification tool. Multi-dimension checks: scene tree integrity, script robustness, performance/resource health, custom behavior assertions, and GDD standards compliance.

  • workflow

    Development workflow tools. dev_loop: execute GDScript with optional validation, bridge queries, and state saving. scene_snapshot: capture structured scene tree snapshot. batch_validate: validate multiple GDScript files at once.

Public scan report

scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it

1 medium
  • Code scan379 source files scanned20/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 12 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Findings (1)

  • mediumeval / new Function usedexec.eval
    build/gdscript-executor.js: …riptBridge\.eval\b/, label: 'JavaScript eval (web escape)' }, { pattern: /\bstr2va…
Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Godot Enhanced compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
85/100
higher than 70% of 48,255 servers
Tools
58
the typical server has 7
Tools that change things
7%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
97
more than 95% of 28,688 servers
Downloads a week
110
more than 65% of 12,191 servers with a package

What its tools let an agent do: 52 read · 5 change · 1 run or deploy

Install Godot Enhanced in Claude Code, Cursor or VS Code

Runs npx -y godot-mcp-enhanced on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add godot-mcp-enhanced -- npx -y godot-mcp-enhanced
Add to Cursor

What the publisher says

From the Godot Enhanced repository's README, as published. We do not edit it. Read it on GitHub

Godot MCP Enhanced

免费 · 开源 · 安全 —— Godot MCP 赛道里少见提供

「系统化安全防护 + 三层架构 + 运行时控制」的开源方案。

给 AI(Claude Code、Cursor、CodeBuddy 等 MCP 客户端)一个能真正读、写、跑、验证 Godot 项目的 工具层:46 个 MCP 工具(merged,共 271 个 action;完整清单见 capability-matrix)覆盖场景/脚本/UI/动画/物理/粒子/导航/音频/测试/导出/3D 参数化资产(asset:11 shape + 路径阵列 + batch 原子 undo),三层架构 (headless + editor + game bridge)+ 路径白名单 / 注入防御 / sandbox 安全体系。 赛道竞品普遍押注「生成」(authoring),本项目押注「验证」(verification)——QA 编排、回归 diff、操作审计与确定性 playtest 共同构成 AI 游戏开发的持续验证管线(CI for AI-assisted game development)。

English · 工具描述为简体中文,服务中文 Godot 开发者社区;欢迎 i18n PR。

小白上手:不用打开 Godot 编辑器也能做游戏

不懂引擎、不想学编辑器?装好 Godot 后,把需求用一句话告诉 AI(「做一个 2048」「给我的角色加二段跳」),读、写、跑、验证全部由 AI 通过本工具完成,全程可以不打开 Godot 编辑器:

  1. 说需求 — AI createproject 建项目、quickscene / write_script 写场景与脚本;
  2. 看效果 — runandverify 真跑一遍并做结构化错误分析,screenshot(action capture)截图给你看现在的样子;
  3. 迭代 — AI editscript 改完自动过 validatescripts 逐脚本编译验证;你只管提意见;
  4. 验收 — qa 用结构化测试套件起真游戏跑断言(playtest.seed 锁随机,同输入可复现);verify_delivery 交付门禁检查场景树完整性 + 脚本健康 + 性能;
  5. 出错不慌 — editor 层操作全进 Godot 原生 undo 栈,AI 改错一步,打开编辑器一步 Ctrl+Z 即回。

连 Godot 都没装? 一条命令自动安装(官方 GitHub releases,SHA512 同源校验,零预装):

npx godot-mcp-enhanced install        # 默认 latest stable;可加版本 tag 如 4.7.2-stable

装到 ~/.godot-mcp/godot// 并自动登记进搜索链与路径白名单;setup 在检测不到 Godot 时也会交互式引导安装。

直接生成一个能玩的游戏? 内置可玩模板(四件套:可玩 demo + GDD + qa 确定性套件 + CSV 调参表):

npx godot-mcp-enhanced init my-game --template=2048    # 或 snake(贪吃蛇)/ breakout(打砖块)
cd my-game
npx godot-mcp-enhanced qa run qa/2048.qa.md --project .   # 真跑游戏跑确定性断言

零外部资产(色块占位美术),零编辑器预打开即可运行;改玩法 = 编辑 tuning/.csv → csvtoresources 重导 .tres → 重启生效;design/gdd/ 内置 8 段游戏设计文档(过 validategdd 校验),AI 拿着它继续迭代。

一条命令把游玩过程录成 demo GIF(分享给朋友/发社区):

npx godot-mcp-enhanced gif . --seconds 8 --fps 4              # 默认方向键;breakout 加 --keys left,right

bridge 定频截图 + 按键时间线注入,零依赖自写 GIF89a 编码器(≤256 色精确直通/中位切分量化);产物默认落项目内 dist/demo.gif,项目外路径需 y/N 确认。

导出成网页,浏览器直接玩(分享链接前先本地试玩):

npx godot-mcp-enhanced web .            # 自动装 export templates(首次 ~1GB)→ 导出 → 起本地服务器

headless --export-release 官方路径导出 + 127.0.0.1 防穿越静态服务器,打印 http://127.0.0.1:/ 即可浏览器游玩;之后可用 web --serve-only <导出目录> 直接重玩。

已在用 Claude Code Game Studios 工作室模板?见 CCGS × 本项目集成指南——它管设计流程,本项目管真实运行验证。

不知道从哪开始? 一条龙向导 skill(game-wizard):四档分诊(没想法/模糊/清晰/已有项目)→ 阶段机(环境→造→改玩法→qa 硬门→导出→分享),每个 gate 以 qa 退出码为准——「不问文档写了吗,问游戏跑通了吗」:

npx godot-mcp-enhanced skills install    # 装入 game-wizard(及另外 6 个技能)后对 AI 说「帮我做一个能玩的游戏」

路线图:一条龙六批(分发声量/install/模板/GIF/Web/向导)已全部落地;后续方向见 ROADMAP。

与同类方案对比

本项目不追求"工具数量第一"。 赛道里,godot-mcp-pro 有 175 个工具但闭源收 $15;

免费的 Coding-Solo 仅 13 个。真正稀缺的不是工具数量,而是「免费 + 开源 + 系统化安全防护」——安全维度在赛道内几乎无人设防。

数据截至 2026-06-27(stars / 工具数 / 价格均可能变化,详见各项目仓库)。

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Godot Enhanced: common questions

Is Godot Enhanced MCP server safe?
Yes, by our scan: it is graded A (85/100). Read the Godot Enhanced safety report
How do I install Godot Enhanced?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Godot Enhanced need an API key?
No secret keys are declared. It reads 3 settings from the environment.
Is Godot Enhanced maintained?
The last commit was 52 days ago (2026-09-13). The latest release is v0.24.0.
How does Godot Enhanced compare with other MCP servers?
safety score 85/100 (higher than 70% of 48,255 servers); tools 58 (the typical server has 7); tools that change things 7% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.