适合谁
- 使用Godot引擎并通过MCP辅助开发的AI代理
- 希望自动化项目启动和调试反馈循环的开发者
- 需要在Godot项目中动态创建和修改场景的AI工具
G
61FMRS · C
该服务器为AI代理与Godot引擎的交互提供了桥梁，支持编辑器启动、项目运行、调试输出捕获等核心功能。其GDScript集成脚本支持复杂场景操作，适合AI辅助游戏开发。安装简单，兼容多种MCP客户端。
Godot MCP服务器使AI代理能够启动Godot编辑器、运行项目、捕获调试输出以及控制项目执行。它提供一个直接的反馈循环，帮助代理理解真实Godot项目中哪些代码有效，从而改进代码生成和调试辅助。该服务器使用捆绑的GDScript脚本来处理复杂操作，如创建场景、添加节点、加载精灵以及导出MeshLibrary资源。
工具能力
launch_editor
启动Godot编辑器以打开特定项目。
run_project
以调试模式运行Godot项目。
get_debug_output
检索控制台输出和错误消息。
stop_project
以编程方式停止正在运行的Godot项目。
get_godot_version
获取已安装的Godot版本。
list_projects
在指定目录中查找Godot项目。
get_project_info
获取有关项目结构的详细信息。
create_scene
使用指定的根节点类型创建新场景。
add_node
向现有场景添加具有可自定义属性的节点。
load_sprite
将精灵和纹理加载到Sprite2D节点。
export_mesh_library
将3D场景导出为GridMap的MeshLibrary资源。
save_scene
保存场景，并可选择创建变体。
get_uid
获取特定文件的UID（适用于Godot 4.4+）。
update_project_uids
通过重新保存资源来更新UID引用（适用于Godot 4.4+）。
安装接入
- 确保您的系统上安装了Godot引擎。\n2. 确保已安装Node.js（>=18.0.0）和npm。\n3. 对于Claude Code，运行：
claude mcp add godot -- npx @coding-solo/godot-mcp。\n4. 对于Cline，将提供的配置添加到Cline MCP设置文件中。\n5. 对于Cursor，通过UI或项目特定的mcp.json添加服务器。\n6. 或者，在运行之前设置环境变量GODOT_PATH和DEBUG。
claude_desktop_config.json
{
"mcpServers": {
"godot": {
"command": "npx",
"args": [
"@coding-solo/godot-mcp"
],
"env": {
"GODOT_PATH": "/path/to/godot",
"DEBUG": "true"
}
}
}
}
选型与风险
不适合谁
- 不使用Godot引擎的开发者
- 需要远程或基于HTTP连接的用户（仅stdio传输）
- 对Godot 4.4+的UID功能没有需求的用户
所需权限
- 执行Godot可执行文件（启动编辑器、运行项目）
- 读取指定的项目目录以列出项目和获取信息
- 在项目目录中写入文件以创建场景、添加节点、保存场景
- 读取控制台输出以捕获调试信息
风险与副作用
- 运行不受信任的Godot项目可能执行任意代码，存在安全风险
- 自动修改项目文件可能导致意外更改，建议使用版本控制
- 如果Godot版本或路径配置不正确，操作可能失败
- 大量操作可能消耗系统资源，影响性能
常见排障
- 若提示未找到Godot，请设置环境变量`GODOT_PATH`为Godot可执行文件的路径。
- 如果连接有问题，请确保服务器正在运行，并重启您的AI助手。
- 如果项目路径无效，请确保路径指向包含`project.godot`文件的目录。
- 如果构建失败，请运行`npm install`安装所有依赖。
- 对于Cursor用户，请确保MCP服务器在设置中启用，并使用Agent聊天配置文件（需要Cursor Pro或商业订阅）。
使用场景
AI驱动的Godot项目开发与调试
自动化场景创建和节点操作
在编码会话中实时捕获游戏运行输出
批量管理项目和场景资源
支持客户端
Claude Desktop完整支持
Cline完整支持
Cursor完整支持