JinDaGe - Godot Script Integration MCP Details

article

README

🚀 Godot MCP（模型上下文协议）

Godot MCP 是一款强大的插件，它基于 Model Context Protocol (MCP)，实现了 Godot 引擎与 AI 助手的全面集成。借助该插件，AI 助手能够无缝与您的 Godot 项目交互，为您提供代码辅助、场景操作和项目管理等一系列强大功能。

✨ 主要特性

完整 Godot 项目访问：AI 助手可自由访问并修改项目中的脚本、场景、节点以及各类资源。
双向通信：既能将项目数据发送给 AI 助手，又能直接在编辑器中应用其给出的修改建议。
丰富的命令类别：
- 节点命令：可轻松创建、修改和管理场景中的节点。
- 脚本命令：支持编辑、分析和创建 GDScript 文件。
- 场景命令：方便操作场景及其结构。
- 项目命令：能访问项目的设置和资源。
- 编辑器命令：可控制各种编辑器功能。

🚀 快速开始

📦 安装指南

1. 克隆仓库

git clone https://github.com/ee0pdt/godot-mcp.git
cd godot-mcp

2. 设置 MCP 服务器

cd server
npm install
npm run build
# 返回项目根目录
cd ..

3. 设置 Claude 桌面版

编辑或创建 Claude 桌面版配置文件：

# 对于 macOS
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

添加以下配置（或参考 included claude_desktop_config.json 作为示例）：

{
  "mcpServers": {
    "godot-mcp": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_PROJECT/server/dist/index.js"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

⚠️ 重要提示

将 PATH_TO_YOUR_PROJECT 替换为您存储此仓库的实际路径。

重启 Claude 桌面版。

4. 在 Godot 中打开示例项目

打开 Godot 引擎。
选择 "导入" 并导航到克隆的仓库。
打开 project.godot 文件。
MCP 插件在此示例项目中已启用。

💻 使用示例

使用 MCP 与 Claude 桌面版

启动插件：在 Godot 中，进入 Project > Project Settings > Plugins 并启用 "Godot MCP"。
连接 AI 助手：确保 Claude 桌面版正在运行，并且 MCP 服务器已正确配置。

创建新场景

打开 Godot 并加载项目。
在编辑器中，右键点击场景树，选择 "Create New Scene"。
配置场景设置并保存。

导出项目

# 在终端中运行以下命令以导出为 HTML5
export_project ../export/html5/

📚 详细文档

资源端点

脚本：*.gd
场景：*.tscn
图片：*.png, *.jpg

命令参考

场景命令

scene/create：创建新场景
scene/open：打开现有场景
scene/save：保存当前场景

节点命令

node/add：添加节点到场景
node/remove：删除指定节点
node/edit：修改节点属性

🔧 技术细节

故障排除

插件未工作：
- 在任何配置更改后重新加载 Godot 项目。
- 检查 Godot 控制台中的错误信息。
- 确保 Claude 桌面版配置中的路径正确无误。

自定义项目集成

将 addons/godot_mcp 文件夹复制到您的 Godot 项目的 addons 目录。
启动项目，进入 Project > Project Settings > Plugins 并启用 "Godot MCP"。

📄 许可证

本项目采用 MIT License 许可证，具体内容请参阅 LICENSE 文件。

贡献

欢迎贡献！请随意提交 Pull Request。

Godot Script Integration