tugcantopaloglu/godot-mcp

解决的问题

Godot MCP 允许 AI 助理以程序化方式控制 Godot 游戏引擎。它弥补了 LLM 编写代码能力与游戏项目实际执行、检查及修改之间的差距，使 AI 能够实时构建、调试与测试游戏。

运作方式

本项目实现了一个模型上下文协议 (MCP) 服务器，向 AI 助理公开 157 种专门工具。这些工具让 AI 能通过两种主要模式与 Godot 互动：

1. 无头场景操作 (Headless Scene Operations)：在无需运行游戏的情况下，修改 .tscn 文件、创建资源并管理项目设置。
2. 运行时互动 (Runtime Interaction)：使用基于 TCP 的服务器来执行 GDScript 代码 (game_eval)、检查节点属性、操作场景树，并在游戏运行时模拟用户输入（键盘、鼠标、游戏手柄）。

它同时支持 GDScript 与 .NET/C# 项目，并提供脚本验证与项目脚手架工具。

目标对象

使用 Godot 4.4+ 的游戏开发者，希望利用 AI 代理来自动化游戏创作、执行运行时调试，或生成复杂的场景结构与逻辑。

特色亮点

• 丰富的工具集：157 种工具，涵盖从 3D/2D 渲染、物理、音频到网络与 UI 控制的所有功能。
• 运行时执行：能够在游戏运行时执行任意 GDScript 代码并等待异步操作。
• 深度内省：在运行时进行完整的节点检查、属性读写与信号管理。
• C# 支持：对构建 .NET 项目与生成 C# 脚本提供一流的支持。
• 无头编辑：无需启动编辑器即可解析并修改场景文件与项目设置。
• 集成诊断：用于无头验证 GDScript 语法与类型错误的工具。