Claude Godot MCP

克劳德·戈多特MCP

Claude的终极Godot MCP服务器——从单个提示构建完整的游戏。

告诉Claude“构建一个具有双跳、3种敌人类型、硬币和主菜单的完整2D平台”，它就可以在Godot中完成所有事情——创建场景、编写脚本、连接信号、设置物理、配置自动加载、运行游戏、模拟输入进行测试、截图结果并导出构建。没有复制粘贴。没有手动步骤。

______________________________________________________________________

这是什么

A. 模型上下文协议 让Claude直接实时控制Godot编辑器的服务器：

• 170工具 涵盖Godot开发的各个方面
• 场景和节点操作 --创建、编辑、保存、删除、重新排序、重命名、烘焙导航
• 脚本操作 --创建、编辑、附加GDScript文件
• 信号布线 --以编程方式连接/断开节点之间的信号
• 组管理 --在组中添加/删除节点
• 自动加载管理 --添加/删除全局单例
• 着色器控制 --在任何节点类型上设置ShaderMaterial参数
• 运行时测试 --播放场景、模拟键盘/鼠标输入、检查实时节点
• 分析器快照 --具有瓶颈检测的N帧上的FPS/内存/绘图调用示例
• 出口管道 --读取/创建导出预设，触发无头构建（HTML5/Win/Android等）
• 导入设置 --读/写。导入文件并触发重新导入
• 取消/重做 --通过EditorUndoRedoManager触发编辑器撤消/重做
• 屏幕截图反馈 --克劳德直观地看到了编辑器和运行游戏
• 资源健康状况 --扫描所有.tscn/.tres以查找损坏的res://references
• 资产发现 --Claude找到并使用你所有的项目精灵、声音、模型
• 插件检测 --Claude检测已安装的插件并使用其节点类型

______________________________________________________________________

快速设置（克劳德代码）

先决条件

• Godot引擎4.2+
• Python 3.10+
• 紫外线 — curl -LsSf https://astral.sh/uv/install.sh | sh

步骤1——安装Godot插件

1. 复制 addons/godot_mcp_enhanced/ 进入您的Godot项目 addons/ 文件夹
2. 在Godot中打开您的项目
3. 首选 项目→ 项目设置→ 插件
4. 启用 Godot MCP增强
5. 检查底部面板——您应该看到“MCP增强：服务器在端口3571上运行”

步骤2——安装Python服务器

cd /path/to/Claude-GoDot-MCP/python
uv venv
uv pip install -e .

步骤3——配置Claude代码

添加到您的项目 .claude/settings.json （或 ~/.claude/settings.json 全球）：

{
  "mcpServers": {
    "godot": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_server"],
      "cwd": "/absolute/path/to/Claude-GoDot-MCP/python",
      "env": {
        "GODOT_HOST": "127.0.0.1",
        "GDAI_MCP_SERVER_PORT": "3571"
      }
    }
  }
}

重新启动克劳德代码。这个 godot MCP服务器现在将显示为可用工具。

步骤4--配置Claude桌面

打开克劳德桌面→ 设置→ 开发者→ 编辑配置，然后添加：

{
  "mcpServers": {
    "godot": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/Claude-GoDot-MCP/python",
        "run",
        "mcp-server"
      ],
      "env": {
        "GODOT_HOST": "127.0.0.1",
        "GDAI_MCP_SERVER_PORT": "3571"
      }
    }
  }
}

重新启动克劳德桌面。

______________________________________________________________________

用法示例

Build a 2D platformer with:
- Player: CharacterBody2D, double-jump, coyote time
- 3 enemy types: patrol, chase, shooter
- Collectible coins with a counter HUD
- Main menu and game over screen
- GameManager autoload for score tracking
Use any sprites you find in my project.

I have a knight model at res://models/knight.glb.
Create a 3D character controller:
- WASD + mouse look
- Attack combo on left click
- Health bar UI
- Death/respawn system
Test with input simulation and show me a screenshot.

My project has the Dialogue Manager plugin.
Create an NPC interaction system:
- Player enters Area2D → dialogue triggers
- 3-branch conversation tree
- NPC portrait shown during dialogue
- Quest flag set on specific dialogue choice

______________________________________________________________________

工具参考（170个工具）

场景操作

节点操作

信号与集团运营

脚本操作

项目配置

文件系统

运行时和测试

资产和插件发现

编辑器和调试

遮光罩和材质

导入设置

出口管道

资源健康状况

TileMap

网格地图

批量操作

动画（扩展）

质量保证/验证

音频

测试/QA

编辑波兰语

物理学

粒子

着色器

动画--库与资源

动画--轨迹管理

动画--关键帧管理

动画--动画树和状态机

骨架

批量附加

项目公用设施

______________________________________________________________________

安全

HTTP服务器绑定到 127.0.0.1 只有--没有外部网络访问。所有文件操作都限制在Godot项目目录中(res://).直接文件系统工具在Python服务器中强制执行项目根边界。

______________________________________________________________________

建筑

Claude (MCP client)
    ↓  stdio
Python MCP Server  (python/mcp_server.py)
    ↓  HTTP POST localhost:3571
Godot HTTP Server  (addons/godot_mcp_enhanced/http_server.gd)
    ↓  GDScript function calls
Operation Modules:
  scene_operations.gd    — scenes, nodes, signals, groups
  script_operations.gd   — GDScript files
  runtime_operations.gd  — input simulation, live inspection
  file_operations.gd     — filesystem, assets
  debugger_integration.gd — errors, logs
  screenshot_manager.gd  — editor + game capture

______________________________________________________________________

故障排除

Godot底部面板中未显示“服务器正在运行”

• 验证插件是否在 res://addons/godot_mcp_enhanced/
• 在Project中启用它→ 项目设置→ 插件
• 检查Godot输出 [Godot MCP Enhanced] ✓ HTTP Server started

MCP工具未出现在Claude中

• 验证 cwd 在settings.json中指向 python/ 目录
• 跑 uv run python -m mcp_server 手动检查错误
• 配置更改后重新启动Claude Code/Claude Desktop

工具调用返回“连接被拒绝”

• Godot编辑器必须在插件处于活动状态时打开
• 检查端口3571未使用： lsof -i :3571
• 验证 GDAI_MCP_SERVER_PORT 匹配Godot底部面板中的端口

截图不起作用

• Godot编辑器窗口必须可见（未最小化）
• DisplayServer屏幕截图API需要Godot 4.2+

______________________________________________________________________

致谢&谢谢

向帮助将其从基本分叉转变为170工具3D引擎的人和人工智能致敬：

• 格罗克 （由xAI建造）——整个项目背后的JARVIS级副驾驶。Grok处理了最初的git设置，建议分叉Rufaty/godot-mcp作为基础，并精心制作了推动升级的每个阶段的提示——动画连接、物理、粒子、着色器、音频、QA、批处理操作、骨架工具、项目实用程序等。在问题出现之前，发现了诸如撤消/重做、导出管道和分析器快照等差距。对付费分叉与免费分叉进行横向分析，在每次会话中保持势头，并以恰到好处的讽刺提供最真实的指导。如果没有Grok的策略、及时的工程和不断迭代的不懈努力，这个项目永远不会达到170个工具。真正的MVP。 🚀

• Rufaty/godot mcp增强 （麻省理工学院授权）——我们建立的坚实基础。

• 更广泛的Godot MCP社区 --tomyud1、Coding Solo、youichi uda的pro fork以及其他人，他们的工作设定了基准，并启发了塑造这只野兽的工具类别。

这个仓库是在大量的人工智能帮助下构建的（Claude代表代码，Grok代表战略）和社区精神。如果你正在阅读这篇文章并贡献了想法或PR，你的名字也会在这里。

______________________________________________________________________

分叉自

Rufaty/godot mcp增强 --通过信号管理、组操作、自动加载管理、批处理操作、类属性发现、save_scene、重命名/重新排序节点以及修复所有运行时工具未路由的关键错误，显著增强了功能。