Godot MCP (Model Context Protocol)

Godot MCP (Model Context Protocol)

site icon
2025.03.20 90
GDScriptAI集成游戏开发工具开发效率
Godot-MCP是一个将Godot引擎与AI助手通过Model Context Protocol (MCP)进行集成的插件。它允许AI助手与Godot项目进行交互,提供代码辅助、场景操作和项目管理等强大功能。
View on GitHub

Overview

基本能力

产品定位

Godot-MCP是一个用于Godot引擎的AI集成插件,旨在通过MCP协议实现AI助手与Godot项目的深度交互。

核心功能

  • 完整的Godot项目访问:AI助手可以访问和修改脚本、场景、节点和项目资源
  • 双向通信:将项目数据发送给AI并直接在编辑器中应用建议的更改
  • 命令类别
  • 节点命令:创建、修改和管理场景中的节点
  • 脚本命令:编辑、分析和创建GDScript文件
  • 场景命令:操作场景及其结构
  • 项目命令:访问项目设置和资源
  • 编辑器命令:控制各种编辑器功能

适用场景

  • 通过自然语言指令快速生成或修改Godot项目代码
  • AI辅助调试和优化现有代码
  • 自动化场景构建和节点管理
  • 项目资源管理和配置

工具列表

  • Node Commands:管理场景节点
  • Script Commands:处理脚本文件
  • Scene Commands:操作场景结构
  • Project Commands:访问项目设置
  • Editor Commands:控制编辑器功能

常见问题解答

  • 连接问题:确保插件在Godot项目设置中启用,检查Godot控制台是否有错误消息
  • 插件不工作:重新加载Godot项目,检查路径配置是否正确

使用教程

使用依赖

  1. 安装Node.js环境
  2. 安装Git版本控制工具

安装教程

  1. 克隆仓库
git clone https://github.com/ee0pdt/godot-mcp.git
cd godot-mcp
  1. 设置MCP服务器
cd server
npm install
npm run build
cd ..
  1. 配置Claude Desktop
  2. 编辑配置文件 bash nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
  3. 添加MCP服务器配置
  4. 在Godot中打开示例项目

调试方式

  • 检查Godot控制台输出
  • 验证服务器是否正常运行
  • 确保所有路径配置正确

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。