Godot MCP

Godot MCP是一个为Godot游戏引擎设计的模型上下文协议服务器，提供编辑器控制、项目运行、调试输出捕获等功能，支持AI助手与Godot引擎的交互。

开发者工具游戏与游戏化 #Godot控制 #游戏开发 #AI集成 #调试工具本地 .JavaScript

评分 : 4分

下载量 : 359

更新时间 : 2025-04-28

What is Godot MCP?

Godot MCP is a bridge between AI assistants and the Godot game engine. It allows AI to directly interact with Godot projects - launching the editor, running games, capturing debug output, and managing project assets - through a standardized interface.

How to use Godot MCP?

After installation, your AI assistant can automatically communicate with the MCP server to perform Godot operations. You simply describe what you want to do (like 'run my game' or 'create a new scene'), and the AI handles the technical details.

Use Cases

Perfect for game developers who want AI assistance with: debugging Godot projects, creating new game assets, testing game mechanics, or learning Godot through interactive examples.

Key Features

Editor ControlLaunch and control the Godot editor for specific projects

Project ExecutionRun Godot projects in debug mode and capture output

Scene ManagementCreate scenes, add nodes, and manage game assets programmatically

Asset HandlingLoad sprites/textures and export 3D models as reusable resources

UID ManagementHandle Godot's unique ID system for files (Godot 4.4+)

Pros and Cons

Advantages

Real-time feedback helps AI provide better Godot assistance

No temporary files - clean project structure

Supports both 2D and 3D workflows

Works with existing Godot installations

Limitations

Requires Godot to be installed on the system

Some features require Godot 4.4 or newer

Advanced 3D operations may have limited support

Setup Guide

Install Dependencies

Ensure you have Node.js and Godot installed on your system

Install MCP Server

Clone and build the Godot MCP server

Configure Your AI Assistant

Add the server configuration to your AI tool (Cursor or Claude)

Start Using

Begin making requests through your AI assistant's chat interface

Example Use Cases

Debugging AssistanceGet help understanding and fixing Godot error messages

Scene CreationQuickly prototype game elements with AI assistance

Asset PipelinePrepare 3D assets for use in Godot

Frequently Asked Questions

Does this work with Godot 3.x?

Can I use this without an AI assistant?

Is my project data sent anywhere?

Additional Resources

Godot Engine Website

Official Godot game engine homepage

GitHub Repository

Source code and issue tracking

Model Context Protocol

Learn about the MCP standard

🚀 Godot MCP服务器配置指南

Godot MCP（Magic Command Processor）服务器是一款用于自动化和增强Godot游戏引擎开发流程的工具。借助MCP，你能够让AI助手直接执行与Godot项目相关的复杂操作，例如创建场景、添加节点、导出资源等。本指南将为你详细介绍如何配置和使用Godot MCP服务器，并提供具体的实现细节和技术支持信息。

🚀 快速开始

下载与构建

克隆代码仓库：

git clone https://github.com/yourusername/godot-mcp.git
cd godot-mcp

安装依赖项：

npm install

构建项目：

npm run build

构建完成后，你会在build/目录下找到可执行文件。

配置环境变量

GODOT_PATH：指定Godot executable的路径（可选）
DEBUG：设置为"true"以启用详细日志记录

✨ 主要特性

可让AI助手直接执行与Godot项目相关的复杂操作，如创建场景、添加节点、导出资源等。
采用特定架构，具有无临时文件、简化代码维护、统一错误处理、减少I/O开销等优势。

📦 安装指南

下载与构建

克隆代码仓库：

git clone https://github.com/yourusername/godot-mcp.git
cd godot-mcp

安装依赖项：

npm install

构建项目：

npm run build

构建完成后，可在build/目录下找到可执行文件。

配置环境变量

GODOT_PATH：指定Godot executable的路径（可选）
DEBUG：设置为"true"以启用详细日志记录

💻 使用示例

基础用法

以下是一些使用场景的例子：

"启动我在/path/to/project位置的游戏项目"

"运行我的Godot项目并显示任何错误信息"

"获取我的Godot项目的结构信息"

"分析我的Godot项目结构并提供建议"

"帮我调试这个错误：[粘贴错误信息]"

"为我编写一个带有双跳和滑墙功能的字符控制器脚本"

🔧 技术细节

架构设计

直接命令：如启动编辑器或获取项目信息等简单操作使用Godot的内置CLI命令。
GDScript脚本：复杂操作（如创建场景、添加节点）通过单个godot_operations.gd脚本实现。

这种架构的优势：

无临时文件
简化代码维护
统一错误处理
减少I/O开销

📚 详细文档

故障排除

常见问题及解决方案：

问题	解决方法
Godot未找到	设置`GODOT_PATH`环境变量
连接问题	确保服务器正在运行并重新启动AI助手
无效路径	确保路径指向包含project.godot文件的目录