Godot MCP Server

Godot MCP 是一个专为 Godot 游戏引擎设计的 Model Context Protocol（MCP）服务器，旨在通过标准化接口，使 AI 助手能够与 Godot 项目进行交互。该工具支持 AI 控制 Godot 编辑器、运行项目、捕获调试输出、管理场景和资源，从而提升游戏开发的自动化程度和效率。

核心功能

Godot MCP 提供了多种核心功能，帮助开发者更高效地管理 Godot 项目：

• 编辑器控制：允许 AI 启动和控制 Godot 编辑器，适用于特定项目的操作。
• 项目运行与调试：支持在调试模式下运行 Godot 项目，并捕获输出信息，便于调试。
• 场景管理：AI 可以创建场景、添加节点，并以编程方式管理游戏资产。
• 资源处理：支持加载精灵、纹理，并导出 3D 模型作为可重用资源。
• UID 管理：支持 Godot 4.4+ 的唯一 ID 系统，便于管理项目文件。

安装方法

安装 Godot MCP 需要 Node.js 和 Godot 已安装在系统中。以下是详细的安装步骤：

brew install node godot

接下来，克隆 Godot MCP 仓库并构建项目：

git clone https://github.com/Coding-Solo/godot-mcp.git

cd godot-mcp

npm install

npm run build

构建完成后，可执行文件将位于 build/ 目录下。

使用方法

Godot MCP 的使用方式非常灵活，AI 助手可以通过自然语言指令与服务器交互，执行各种 Godot 操作。以下是一些使用示例：

"启动我在/path/to/project位置的游戏项目"

"运行我的Godot项目并显示任何错误信息"

"获取我的Godot项目的结构信息"

"分析我的Godot项目结构并提供建议"

"帮我调试这个错误：[粘贴错误信息]"

"为我编写一个带有双跳和滑墙功能的字符控制器脚本"

此外，Godot MCP 还支持通过命令行直接调用，例如：

launch_editor
create_scene

这些命令可以用于自动化创建场景、添加节点等操作。

使用场景

Godot MCP 适用于多种游戏开发场景，包括但不限于：

• 调试 Godot 项目中的错误
• 创建新的游戏资产，如场景、节点、资源
• 测试游戏机制，如角色控制、物理交互
• 学习 Godot 的使用方法，通过交互式示例快速上手

注意事项

在使用 Godot MCP 时，需要注意以下几点：

• 必须在系统中安装 Godot，且版本建议为 4.4 或以上以支持 UID 管理。
• 部分高级 3D 操作可能支持有限。
• AI 助手的配置需要正确设置，以确保与 MCP 服务器的通信。

Godot MCP 通过标准化接口，将 AI 助手与 Godot 游戏引擎紧密结合，为开发者提供了一个高效、灵活的开发工具。无论是调试、资源管理还是项目自动化，Godot MCP 都能显著提升开发效率。