← 返回目录

Godot MCP Server

社区

通过MCP与Godot游戏引擎交互的服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 108 / 438
Stars: ★ 6.1k 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+ · 预编译二进制
凭据: 无需凭据
许可证: MIT
最近提交: 6 个月前 ⚠
工具数: 14

61FMRS · C

该服务器为AI代理与Godot引擎的交互提供了桥梁，支持编辑器启动、项目运行、调试输出捕获等核心功能。其GDScript集成脚本支持复杂场景操作，适合AI辅助游戏开发。安装简单，兼容多种MCP客户端。

最强项 · 安装易用性 14/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

11/20

维护活跃度

14/20

文档质量

13/20

安装易用性

14/20

查看各项评分依据

可靠性 9/20: 服务器源码结构完整，TypeScript 构建和主入口明确，工具声明与实现基本一致。但未提供测试或 CI 工作流，无法从静态证据中确证关键路径的可复现性，错误处理和边界情况（如 Godot 未安装、路径无效）仅在代码中部分处理，文档中的故障排查部分与实现不完全匹配。因此可靠性评分为 9。
安全与权限 11/20: 服务器通过命令行调用 Godot，无凭据处理；环境变量 GODOT_PATH 和 DEBUG 设计合理，无网络外发或恶意操作。但缺少对危险操作（如停止项目、创建场景）的显式确认机制，且工具列表未包含权限分级或用户确认步骤。文档建议在 Cline 的 autoApprove 中列出所有工具，但服务器自身没有实施最小权限或确认策略。未发现红线问题，因此得分为 11。
维护活跃度 14/20: 仓库活跃，有 5104 星和最近提交，许可证为 MIT，维护者提供赞助链接，但缺少版本发布记录和依赖更新策略，问题响应未见证据。因此维护得分为 14。
文档质量 13/20: README 提供了详细的安装指南、环境变量说明、客户端配置示例（Claude、Cline、Cursor）和故障排查，但缺少工具参数的详细文档、使用限制、成本说明和测试证据。文档与实际功能基本一致，但存在隐含假设（如 Godot 路径检测），因此得分为 13。
安装易用性 14/20: 安装步骤清晰，支持 npx 和源码构建，提供了多种 MCP 客户端配置示例。但依赖外部 Godot 引擎安装，且未提供 Windows/macOS 的详细平台特定说明，源码构建需要手动步骤。由于缺少测试和 CI，setup 得分上限为 15，按静态证据评分为 14。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件执行命令或代码

适合谁

使用Godot引擎并通过MCP辅助开发的AI代理
希望自动化项目启动和调试反馈循环的开发者
需要在Godot项目中动态创建和修改场景的AI工具

不适合谁

不使用Godot引擎的开发者
需要远程或基于HTTP连接的用户（仅stdio传输）
对Godot 4.4+的UID功能没有需求的用户

所需权限

执行Godot可执行文件（启动编辑器、运行项目）
读取指定的项目目录以列出项目和获取信息
在项目目录中写入文件以创建场景、添加节点、保存场景
读取控制台输出以捕获调试信息

风险与副作用

运行不受信任的Godot项目可能执行任意代码，存在安全风险
自动修改项目文件可能导致意外更改，建议使用版本控制
如果Godot版本或路径配置不正确，操作可能失败
大量操作可能消耗系统资源，影响性能

安装接入

准备工作

运行环境：Node.js 18+ · 预编译二进制

其他可选配置项（2 个）

GODOT_PATH 可选 Godot 可执行文件的路径，用于覆盖自动检测；从 godotengine.org 下载安装后填写其路径。仅当自动检测失败时需要设置。

DEBUG 可选设为 "true" 可开启服务器端详细调试日志；可选，非密钥。

确保您的系统上安装了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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "godot": {
      "command": "npx",
      "args": [
        "@coding-solo/godot-mcp"
      ],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add godot -e GODOT_PATH=/path/to/godot -e DEBUG=true -- npx @coding-solo/godot-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端的工具列表中应出现 launch_editor、run_project、get_debug_output 等 14 个工具；也可以直接询问“安装的 Godot 版本是多少”，get_godot_version 返回版本号即说明连接成功。

常见排障

若提示未找到Godot，请设置环境变量`GODOT_PATH`为Godot可执行文件的路径。
如果连接有问题，请确保服务器正在运行，并重启您的AI助手。
如果项目路径无效，请确保路径指向包含`project.godot`文件的目录。
如果构建失败，请运行`npm install`安装所有依赖。
对于Cursor用户，请确保MCP服务器在设置中启用，并使用Agent聊天配置文件（需要Cursor Pro或商业订阅）。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我启动当前 Godot 项目的编辑器
以调试模式运行这个 Godot 项目，然后给我看看输出的错误信息
列出 D:/MyGames 目录下所有的 Godot 项目
在这个场景里新建一个根节点为 Node2D 的场景，并添加一个 Sprite2D 节点

工具能力 14

launch_editor 写入

启动Godot编辑器以打开特定项目。

run_project 写入

以调试模式运行Godot项目。

get_debug_output 只读

检索控制台输出和错误消息。

stop_project 写入

以编程方式停止正在运行的Godot项目。

get_godot_version 只读

获取已安装的Godot版本。

list_projects 只读

在指定目录中查找Godot项目。

get_project_info 只读

获取有关项目结构的详细信息。

create_scene 写入

使用指定的根节点类型创建新场景。

展开其余 6 个工具

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+）。

使用场景

AI驱动的Godot项目开发与调试

自动化场景创建和节点操作

在编码会话中实时捕获游戏运行输出

批量管理项目和场景资源

支持客户端

Claude Desktop

Cline

Cursor

依据项目文档列出，未经本站实测。

详细介绍

Godot MCP服务器使AI代理能够启动Godot编辑器、运行项目、捕获调试输出以及控制项目执行。它提供一个直接的反馈循环，帮助代理理解真实Godot项目中哪些代码有效，从而改进代码生成和调试辅助。该服务器使用捆绑的GDScript脚本来处理复杂操作，如创建场景、添加节点、加载精灵以及导出MeshLibrary资源。