Godot MCP Pro

Godot MCP Pro

用于AI驱动的Godot游戏开发的高级MCP（模型上下文协议）服务器。使用以下命令将Claude等AI助手直接连接到您的Godot编辑器 172强大的工具.

建筑

AI Assistant ←—stdio/MCP—→ Node.js Server ←—WebSocket:6505—→ Godot Editor Plugin

• 实时：WebSocket连接意味着即时反馈，无文件轮询
• 编辑器集成：完全访问Godot的编辑器API、UndoRedo系统和场景树
• JSON-RPC 2.0：带有正确错误代码和建议的标准协议

这个回购中有什么

⚠️ 此公共仓库仅包含免费的Godot插件。 MCP服务器（Node.js，连接AI助手所需）作为付费包的一部分分发-- 一次性购买，终身更新： - 请我喝杯咖啡: - itch.io: 付费压缩包包括插件、 server/ 带有预构建JavaScript的目录， INSTALL.md，以及AI客户端指令。如果你克隆了这个仓库，但没有看到 server/ 文件夹， 这是意料之中的 --从上面的链接中获取完整的包。

快速开始

1.安装Godot插件

复制 addons/godot_mcp/ 将文件夹放入Godot项目的 addons/ 目录。

启用插件： 项目→ 项目设置→ 插件→ Godot MCP Pro→ 启用

2.安装MCP服务器

这 server/ 目录仅包含在 全额付费套餐 （见上文）。下载并解压缩zip后，运行：

cd server
npm install
npm run build

3.配置克劳德代码

添加到您的 .mcp.json:

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"],
      "env": {
        "GODOT_MCP_PORT": "6505"
      }
    }
  }
}

4.选择您的模式

Godot MCP Pro提供了四种模式来适应任何客户端的工具限制：

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js", "--lite"]
    }
  }
}

替换 --lite 随着 --minimal 以实现最小的占地面积。

• 精简版 包括：项目、场景、节点、脚本、编辑器、输入、运行时和inputmap工具。
• 最小化 包括：35个基本工具——项目信息、场景管理、节点CRUD、脚本编辑、编辑器错误、输入模拟和运行时检查。

5.CLI模式（MCP的替代方案）

对于不支持MCP的客户端，或者当您希望零上下文开销时，可以直接从终端/bash工具使用CLI。CLI要求首先构建服务器（步骤2）。

# Top-level help — shows all command groups
node /path/to/server/build/cli.js --help

# Group help — shows commands in a group
node /path/to/server/build/cli.js node --help

# Command help — shows options for a command
node /path/to/server/build/cli.js node add --help

# Execute
node /path/to/server/build/cli.js project info
node /path/to/server/build/cli.js scene play
node /path/to/server/build/cli.js node add --type CharacterBody3D --name Player

替换 /path/to/ 使用提取文件的实际路径。

CLI通过WebSocket直接连接到Godot编辑器插件。它要求：

• 启用MCP插件运行的Godot编辑器
• 服务器已构建(node build/setup.js install)
• 6510-6514范围内的可用端口

优势：LLM通过以下方式逐步发现能力 --help 而不是预先加载所有工具定义。这适用于任何具有终端访问权限的LLM客户端，而不管工具数量限制如何。

6.客户端兼容性

7.使用它

打开启用了插件的Godot项目，然后使用Claude Code与编辑器进行交互。

全部172工具

项目工具（7）

场景工具（9）

节点工具（14）

脚本工具（8）

编辑器工具（9）

输入工具（7）

运行时工具（19）

动画工具（6）

TileMap工具（6）

主题和UI工具（6）

分析工具（2）

批处理和重构工具（8）

着色器工具（6）

导出工具（3）

资源工具（6）

物理工具（6）

三维场景工具（6）

粒子工具（5）

导航工具（6）

音频工具（6）

动画树工具（4）

国家机床（3）

混合树工具（1）

分析和搜索工具（4）

测试和质量保证工具（6）

主要特点

• 撤销集成：所有节点/属性操作都支持Ctrl+Z
• 智能类型解析: "Vector2(100, 200)", "#ff0000", "Color(1,0,0)" 自动转换
• 自动重新连接：指数退避重新连接（1秒→ 2s → 4s ... → 60s最大值）
• 心跳：10秒乒乓球保持连接畅通
• 有用的错误：错误响应包括对下一步的建议

竞争比较

工具计数

特征矩阵

独家类别（没有竞争对手有这些）

建筑优势

许可证

专有——见 许可证 了解详情。购买包括终身更新。