Godot MCP
连接Godot引擎与AI助手的双向交互与项目管理工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:Godot MCP。 它的用途是:连接Godot引擎与AI助手的双向交互与项目管理工具 完整的 Skill 内容见:https://321skill.com/skills/godot-mcp-godot-mcp/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我在Godot里创建了一个CharacterBody2D节点,但角色无法移动,帮我检查并修复GDScript代码。”,它会根据当前场景上下文分析你的脚本,指出可能缺少的`_physics_process`函数或速度设置错误,并提供可直接粘贴运行的修正代码。或者,你可以说:“为我的平台游戏项目规划一个简单的状态机结构”,它会生成包含Idle、Run、Jump状态的GDScript代码框架,并提示如何在Godot中创建相关节点和脚本。
介绍
Godot MCP是一个专为Godot游戏引擎设计的模型上下文协议(MCP)集成工具,旨在解决游戏开发者在引擎内与AI助手协作时的割裂问题。它允许开发者直接在Godot编辑器环境中与AI对话,无需频繁切换窗口,即可获取代码建议、调试帮助或项目管理指导。
该工具通过MCP协议建立桥梁,将Godot引擎的实时状态(如当前场景、节点树、脚本错误)提供给AI助手,同时也能接收并执行AI返回的指令或代码片段,实现从查询到修改的无缝闭环。用户可以通过配置的AI助手(如Claude、Cursor等)直接操作Godot项目。
它非常适合使用Godot引擎进行游戏开发或原型设计的开发者,特别是那些希望利用AI提升编码效率、快速解决引擎特定问题或管理复杂项目结构的个人或小团队。无论是初学者寻求学习指导,还是资深开发者优化工作流,都能从中受益。
使用前请确保已正确配置MCP服务器及兼容的AI助手客户端。注意,AI生成的代码或操作建议需经过人工审查,尤其是在涉及项目核心逻辑或资产时。建议在非关键项目或备份环境下先行试用,熟悉其交互模式与能力边界。
核心特点
这是首个专为Godot引擎深度定制的MCP工具,实现了引擎内部状态(如场景树、资源路径)与AI上下文的双向同步,而非仅提供通用代码片段。它直接集成到Godot编辑器中,允许AI理解并操作具体的Godot项目结构,提供了从代码生成到引擎内执行的完整工作流。
注意事项
目前主要专注于Godot引擎的代码与项目管理,不适合非Godot项目或需要深度图形渲染、物理模拟等引擎底层调试的场景。
常见问题
Godot MCP支持哪些AI助手?
支持任何实现了MCP客户端协议的AI助手,如Claude Desktop、Cursor等,需在对应客户端中配置MCP服务器。
它能在Godot中直接运行AI生成的代码吗?
可以,工具能将AI返回的GDScript代码片段或操作指令在Godot编辑器中应用或执行,但建议先审查再应用。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/godot-mcp-godot-mcp/raw/index.md 读取 Godot MCP 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/godot-mcp-godot-mcp/raw/index.md(查看排版版本)