MCP Gdot

Godot MCP-高级AI桥

🎮 全功能的Godot编辑器集成+离线项目分析，用于AI辅助游戏开发

此MCP服务器使Claude（或任何兼容MCP的AI）能够：

• 实时操作Godot编辑器 -创建节点、修改场景、放置对象
• 离线了解您的项目 -分析脚本、查找依赖关系、搜索代码
• 按比例进行水平设计 -分散物体、地形感知放置、批量操作

建筑

┌─────────────┐           ┌─────────────────────────────────────────┐
│             │           │            MCP Server (Python)          │
│   Claude    │◄─stdio───►│  ┌─────────────┐  ┌─────────────────┐   │
│             │           │  │ Live Tools  │  │ Offline Analysis│   │
└─────────────┘           │  │ (HTTP→Godot)│  │ (File Parsing)  │   │
                          │  └──────┬──────┘  └─────────────────┘   │
                          └─────────┼───────────────────────────────┘
                                    │ HTTP :6550
                          ┌─────────▼───────────┐
                          │   Godot Editor      │
                          │   Claude Bridge     │
                          │   (@tool plugin)    │
                          └─────────────────────┘

快速开始

1.安装Godot插件

复制 godot-plugin/addons/claude_bridge/ 对于您的项目：

your_project/
└── addons/
    └── claude_bridge/
        ├── plugin.cfg
        └── plugin.gd

启用： 项目→ 项目设置→ 插件→ 克劳德·布里奇

2.安装Python依赖项

cd mcp-server
pip install -r requirements.txt

3.配置克劳德桌面

添加到 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "godot": {
      "command": "python",
      "args": ["C:\\Projects\\mcp-Gdot\\mcp-server\\server.py"]
    }
  }
}

重新启动克劳德桌面。

______________________________________________________________________

工具类别

🔌 连接和设置

🌳 场景树（直播）

🎯 选择

➕ 节点操作

📦 场景实例化

🗺️ 水平设计和地形

⚡ 批量操作

🔍 搜索

🐛 调试

💻 脚本执行

______________________________________________________________________

离线分析（无需Godot！）

这些工具直接解析您的项目文件——Godot不需要运行。

______________________________________________________________________

示例提示

关卡设计

"Scatter 100 oak trees in a 200m radius around the player spawn,
 avoid slopes over 30 degrees, minimum 5m spacing, random Y rotation"

"Place torches along the path from the entrance to the boss room,
 10 meters apart, aligned to face the path direction"

"Create a 5x5 grid of market stalls starting at (100, 0, 100)"

批量操作

"Set all WildlifeSpawner nodes to respawn_time = 300"

"Delete all nodes in the 'debug' group"

"Replace all instances of old_tree.glb with new_tree.glb"

项目分析

"Find all scripts that use the 'damage_dealt' signal"

"What functions does the PlayerCombat class have?"

"Show me the dependency graph - what loads what"

"Find orphaned scenes that aren't used anywhere"

定制操作

"Run this code on all selected nodes: node.modulate = Color.RED"

"Execute: print(scene_root.get_children())"

______________________________________________________________________

扩展插件

添加新端点

1. 在中添加处理程序 plugin.gd:

func _my_handler(data: Dictionary) -> Dictionary:
    # Do stuff
    return {"success": true, "data": result}

1. 添加路线 _route_request():

"my/endpoint": return _my_handler(data)

1. 添加工具 server.py:

Tool(
    name="godot_my_tool",
    description="Does cool stuff",
    inputSchema={...}
)

1. 添加到端点映射 call_tool().

______________________________________________________________________

故障排除

“无法连接到Godot”

• Godot正在运行吗？
• 插件是否已启用？检查项目设置→ 插件
• 检查输出面板上的“Claude Bridge:服务器正在监听…”

离线分析不起作用

• 你打电话来了吗 godot_set_project 第一？
• 路径是否正确（应包含project.godot）？

地形光线投射不返回命中值

• 你的地形有碰撞吗？
• 碰撞层是否正确？

______________________________________________________________________

许可证

麻省理工学院-随心所欲！ 🚀