企业官网建设流程全解析

4步将 Godot-MCP 插件集成到 Godot 项目：从复制 addons 到启用插件的完整指南

【免费下载链接】Godot-MCPAn MCP for Godot that lets you create and edit games in the Godot game engine with tools like Claude项目地址: https://gitcode.com/gh_mirrors/god/Godot-MCP

Godot-MCP 插件是一款基于模型上下文协议（MCP）的 Godot 编辑器插件，它让 Claude 等 AI 助手可以直接操作你的 Godot 项目——创建节点、编写 GDScript、管理场景。本教程将带你从零开始，完成 Godot MCP 插件的安装与启用，只需 4 个简单步骤。🎮

一、认识 Godot-MCP 插件：它能做什么？

Godot-MCP 插件在 Godot 编辑器内部启动一个 WebSocket 服务器（默认端口 9080），作为 AI 与编辑器之间的"桥梁"。启用后，它提供五大类能力：

插件的核心入口是 addons/godot_mcp/mcp_server.gd，它负责在编辑器启动时监听端口并接收 AI 发来的指令。

二、快速了解插件文件结构

在动手之前，先花 30 秒了解你要复制的内容。Godot-MCP 的插件部分全部位于addons/godot_mcp/目录：

addons/godot_mcp/ ├── plugin.cfg # 插件配置（名称、版本、入口脚本） ├── mcp_server.gd # 主插件 + WebSocket 服务器 ├── command_handler.gd # 命令路由与执行 ├── commands/ # 各类命令实现 ├── ui/ # MCP 控制面板 └── utils/ # 节点/脚本/资源工具函数

其中 plugin.cfg 声明了插件名称 "Godot MCP" 和入口脚本mcp_server.gd，Godot 正是靠它识别这个插件。

三、集成四步法（核心步骤）

第 1 步：获取 Godot-MCP 仓库

打开终端，克隆仓库到本地：

git clone https://gitcode.com/gh_mirrors/god/Godot-MCP cd Godot-MCP

💡 如果你已经通过仓库自带的示例项目测试过插件（参考 project.godot，该示例项目已预启用插件），可以跳过本步，直接从第 2 步开始。

第 2 步：复制 addons 目录到你的 Godot 项目

这是最关键的一步。把 Godot-MCP 仓库中的godot_mcp文件夹整体复制到你自己的 Godot 项目的addons目录下（若项目没有addons目录则新建一个）：

你的Godot项目/ ├── addons/ │ └── godot_mcp/ ← 把整个文件夹拷进来 │ ├── plugin.cfg │ ├── mcp_server.gd │ └── ... ├── project.godot └── ...

⚠️注意：复制的是godot_mcp文件夹本身，不要复制成addons/godot_mcp/godot_mcp这样的嵌套结构。

第 3 步：在 Godot 中启用插件

1. 用 Godot（4.x 版本）打开你的项目
2. 进入菜单栏Project → Project Settings → Plugins
3. 在列表中找到Godot MCP，勾选启用它 ✅

启用后，mcp_server.gd会在_enter_tree()时自动启动 WebSocket 服务器并监听 9080 端口，同时编辑器右侧停靠栏会出现 MCP 控制面板。

第 4 步：验证安装成功

• 打开右侧停靠面板（Dock），确认能看到MCP 面板（对应 addons/godot_mcp/ui/mcp_panel.tscn 场景）
• 打开 Godot 的输出控制台（Output），应看到=== MCP SERVER STARTING ===与Listening on port 9080的日志
• 面板状态指示变绿，说明服务器已就绪，AI 可以随时连进来干活 🚀

四、常见问题排查（Troubleshooting）

五、下一步：连接 AI 助手

插件启用后，还需要配置 MCP 服务端并把它接入 Claude Desktop。完整流程可参考项目自带文档：

• 安装全流程：docs/installation-guide.md
• 上手示例（让 AI 帮你搭场景、写移动脚本）：docs/getting-started.md
• 完整命令清单：docs/command-reference.md
• 架构设计原理：docs/architecture.md

配置完成后，你就可以用自然语言指挥 AI："创建一个主菜单，包含开始、选项和退出按钮"——剩下的节点搭建和脚本编写，交给 Godot-MCP 插件自动完成吧！✨

【免费下载链接】Godot-MCPAn MCP for Godot that lets you create and edit games in the Godot game engine with tools like Claude项目地址: https://gitcode.com/gh_mirrors/god/Godot-MCP