戈多特-MCP

Name: 戈多特-MCP
Author: hhhh124hhhh

作者：hhhh124hhhh7 星标更新：2025-11-15

安装使用来源：spider==github.com

项目介绍

Godot MCP (模型上下文协议)

Godot引擎与AI助手之间的一整套综合解决方案，采用模型上下文协议（MCP）实现。此插件允许AI助手与您的Godot项目进行交互，提供强大的代码辅助、场景操作和项目管理功能。

🌟 主要特性

🤖 智能技能系统

Context7自动研究自动获取最新的Godot文档和最佳实践
Godot兼容性检查器自动检测并修复从Godot 3.x到4.x的API兼容性问题
MCP编排工具智能协调多个MCP工具以完成复杂的开发任务
中文开发指南为中文开发者提供完整的本地化配置和开发指导

🔧 强大的MCP工具集

Godot兼容性工具：
- detect_godot_version - 测试项目的Godot版本
- check_godot_api_compatibility - 检查API兼容性问题
- fix_godot_api_compatibility - 自动修复兼容性问题
- get_godot_migration_advice - 获取版本迁移建议
标准开发工具：
- 节点工具 创建、修改和删除节点
- 脚本工具 编辑、分析和创建GDScript文件
- 场景工具 操作场景和结构
- 编辑器工具 控制编辑器功能
增强开发工具：
- Chrome DevTools Web调试和性能分析
- 顺序思维 结构化思考和问题分解
- Context7 获取最新库文档和API信息

🎯 自动代码生成

智能触发 在需要代码生成、配置步骤或库文档查询时自动使用Context7 MCP工具
实时文档查询 不需要显式请求，系统自动获取最新的技术文档
最佳实践应用 根据项目实际情况提供最优解决方案

🎮 技术基础：Godot引擎

Godot MCP基于Godot 4.x引擎构建，是我们技术基础和AI自动化开发平台。

⚙️ Godot 4.x系统要求

推荐版本 Godot 4.3+（兼容4.2+）
支持平台 Windows 10+、macOS 10.13+、Linux (Ubuntu 18.04+)
下载链接 官方下载页面

🎯 为什么选择Godot作为基础引擎？

一 AI友好架构

结构化的项目文件格式
清晰的API设计和命名规范
完整的节点系统和场景管理
热重载功能，实时查看修改效果

二轻量且强大

完全免费且开源
零配置即可开始开发
丰富的内置功能减少开发时间
支持跨平台导出

三现代技术栈

新的Vulkan渲染后端
改进的物理引擎和UI系统
支持多线程渲染和资源优化

🛠️ 与Godot MCP集成的优势

godot-mcp通过MCP协议无缝集成AI能力与Godot引擎：

🤖 AI驱动开发 自然语言命令自动生成代码和配置
🔧 智能工具 节点操作、脚本编辑、场景管理等
🎨 自动化测试 AI辅助的功能验证和问题排查
📚 实时学习 自动获取最新的Godot文档和最佳实践

📚 Godot学习资源

官方文档 https://docs.godotengine.org/
示例项目 https://github.com/godotengine/godot-demo-projects
社区资源 https://godotengine.org/asset-library/asset

🚀 快速入门

🎉 专为新手用户 执行 ./setup-mcp-tools.sh (Linux/macOS) 或 setup-mcp-tools.bat (Windows) 一键配置所有AI技能！

📖 详细指南 查看快速AI技能配置指南或5分钟快速入门指南

⚡ 一键配置（推荐）

Linux/macOS用户：

git clone https://github.com/hhhh124hhhh/godot-mcp.git
cd godot-mcp
./setup-mcp-tools.sh

Windows用户：

git clone https://github.com/hhhh124hhhh/godot-mcp.git
cd godot-mcp
setup-m

脚本将自动：

✅ 检查系统环境（Node.js 18+）
✅ 安装4个核心MCP工具
✅ 构建Godot MCP服务器
✅ 生成完整的Claude Desktop配置代码
✅ 验证所有AI技能文件

📋 手动安装步骤

1. 克隆仓库

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

二 🎮 安装Godot引擎

系统要求 Godot 4.2+（推荐版本4.3或更高）

快速安装方法

# macOS（使用Homebrew）
brew install --cask godot

# Windows（使用Chocolatey）
choco install godot

# Ubuntu/Debian
sudo apt update
sudo apt install godot4

提示：也可以从Godot官方网站或Steam商店下载

验证安装

godot --version
# 应显示: 4.x.stable.official [hash]

3. 设置MCP服务器

cd server
npm install
npm run build
# 返回项目根目录
cd ..

4. 配置Claude Desktop

编辑Claude Desktop配置文件：

# macOS
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Linux
nano ~/.config/claude/claude_desktop_config.json

# Windows
# 使用VS Code或其他编辑器编辑
# %APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "godot-mcp": {
      "command": "node",
      "args": [
        "PATH_TO_YOUR_PROJECT/server/dist/index.js"
      ],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

注意：将PATH_TO_YOUR_PROJECT替换为仓库的绝对路径。

重启Claude Desktop

🎯 专为新手用户：一键配置AI技能

🎉 特别为新手用户设计 我们提供了一键配置脚本，自动设置所有四个核心AI技能所需的MCP工具。

🚀 一键配置（推荐）

运行自动配置脚本：

# 进入项目目录
cd godot-mcp

# 运行一键配置脚本
./setup-mcp-tools.sh

脚本将自动完成：

✅ 检查Node.js和npm环境
✅ 安装所需MCP工具
✅ 验证AI技能文件的完整性
✅ 构建Godot MCP服务器
✅ 生成完整的配置代码

📋 手动配置（适用于高级用户）

如果需要手动配置，请按照以下步骤操作：

步骤1：安装MCP工具

# Chrome DevTools MCP（网页调试）
npm install -g chrome-devtools-mcp

# 顺序思维MCP（逻辑推理）
npm install -g sequential-thinking-mcp

# Context7 MCP（文档研究）
npm install -g context7-mcp-server

步骤2：配置Claude Desktop 编辑配置文件并添加以下MCP服务器：

{
  "mcpServers": {
    "godot-mcp": {
      "command": "node",
      "args": ["YOUR_PROJECT_PATH/server/dist/index.js"],
      "env": {
        "MCP_TRANSPORT": "stdio"
      }
    },
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest"]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": ["sequential-thinking-mcp"]
    },
    "context7": {
      "command": "npx",
      "args": ["context7-mcp-server"]
    }
  }
}

🧠 四大核心AI技能详解

配置完成后，您将获得以下四种强大的AI技能：

一 🤖 Context7自动研究技能

功能自动获取最新的技术文档和最佳实践
触发条件 关键词如“如何实现”、“配置”、“文档”等
目的不需要手动搜索，AI自动为您找到最新信息

示例：

用户: "如何实现 Godot 4.x 彩色粒子效果"
→ AI 自动查询官方文档，返回完整实现方案

二 🎮 Godot兼容性检查技能

功能自动检测并修复版本兼容性问题
触发条件 版本升级、API错误、兼容性问题
目的解决从Godot 3.x到4.x的API迁移问题

示例：

用户: "遇到错误：Invalid assignment of property 'emission_amount'"
→ AI 自动识别问题并提供修复方案

三 🔧 MCP工具编排技能

功能智能协调多个工具以完成复杂任务
触发条件 多步骤开发过程、工具链协作
目的自动化复杂工作流程以提高开发效率

示例：

用户: "创建一个完整的游戏主菜单系统"
→ AI 自动协调 UI设计、脚本编写、测试验证等步骤

四 🌏 中文开发指南技能

功能完整的中文环境配置和开发指导
触发条件 中文沟通和本地化需求
目的解决中文编码和显示相关的问题，并提供本地化支持

示例：

用户: "如何配置中文开发环境"
→ AI 提供完整的中文化配置方案

🎮 验证配置成功

测试AI技能：

重启Claude Desktop
发送测试消息："如何实现一个简单的 Godot 粒子效果"
观察AI是否自动触发context7-auto-research技能
检查返回的内容是否包含详细的实施方案

技能状态检查：

# 检查技能文件是否存在
ls -la .claude/skills/

# 验证MCP工具连接
claude mcp list

# 运行完整验证脚本
./verify-mcp-setup.sh

五 🎮 在Godot中打开一个示例项目

启动Godot编辑器
点击“导入”按钮导航至克隆的仓库
选择examples/bubble-game-demo/文件夹
点击“导入项目”按钮
确保插件已启用（项目设置 → 插件 → Godot MCP）

六 🚀 开始AI自动开发之旅

现在您可以：

💡 使用示例

自动技能触发示例

用户: "如何实现 Godot 4.x 的彩色爆炸粒子效果"
→ 自动触发 context7-auto-research 技能
→ 调用 Context7 MCP 查询相关文档
→ 返回完整的实现方案

用户: "遇到 Godot 兼容性错误：Invalid assignment of property 'emission_amount'"
→ 自动触发 godot-compatibility-checker 技能
→ 调用 Godot MCP 检测和修复问题
→ 返回修复后的代码

MCP工具使用示例

用户: "检查我的 Godot 项目版本兼容性"
→ 自动调用 detect_godot_version 工具
→ 返回版本信息和兼容性建议

用户: "修复这些 Godot 3.x 到 4.x 的兼容性问题"
→ 自动调用 fix_godot_api_compatibility 工具
→ 返回修复后的代码和迁移说明

自然语言开发任务

创建一个带有开始、设置和退出按钮的主菜单
为玩家角色添加碰撞检测
实现昼夜循环系统
使用信号而不是直接引用重构代码
调试玩家角色有时穿过地板的问题

🛠️ 可用MCP工具的详细描述

Godot兼容性工具

detect_godot_version

功能检查项目使用的Godot版本和配置信息 使用场景：

开始新项目时确认目标版本
遇到版本相关错误时诊断
自动构建过程中版本检查

check_godot_api_compatibility

功能检查GDScript代码中的API兼容性问题参数：

code 要检查的GDScript代码
targetVersion 目标版本（'3.x', '4.x', 'auto'）
projectPath 项目路径（可选）

fix_godot_api_compatibility

功能自动修复GDScript代码中的API兼容性问题 支持的修复：

Tween系统：interpolate_property() → tween_property()
渐变系统：get_color_at_offset() → get_color(index)
输入系统：现代化信号连接语法
节点操作：安全节点访问模式
信号系统：lambda表达式支持
粒子系统：ParticlesMaterial → ParticleProcessMaterial

get_godot_migration_advice

功能获取Godot版本迁移建议和最佳实践输出详细的迁移指南和代码示例

核心MCP工具

节点操作工具

get-scene-tree - 返回场景树结构
get-node-properties - 获取特定节点的属性
create-node - 创建新节点
delete-node - 删除节点
modify-node - 更新节点属性

脚本编辑工具

list-project-scripts - 列出项目中的所有脚本
read-script - 读取特定脚本
modify-script - 更新脚本内容
create-script - 创建新脚本
analyze-script - 提供脚本分析

场景管理工具

list-project-scenes - 列出项目中的所有场景
read-scene - 读取场景结构
create-scene - 创建新场景
save-scene - 保存当前场景

项目管理工具

get-project-settings - 获取项目设置
list-project-resources - 列出项目资源
get-project-info - 获取项目元数据

🧠 技能系统详解

Context7自动研究技能

触发条件 关键词如“如何实现”、“配置”、“文档”等
功能自动搜索最新的技术文档和最佳实践
优势不需要手动查询，实时访问最新信息

Godot兼容性检查技能

触发条件 版本升级、API错误、兼容性问题
功能基于实际项目经验的修复计划
数据库 完整的Godot 3.x到4.x API变更映射

MCP编排技能

触发条件 多步骤开发过程、工具链协作
功能支持四种执行模式：串行、并行、条件、循环
优势智能协调复杂任务

中文开发指南技能

触发条件 中文沟通和本地化需求
功能完整配置中文文化开发环境
包括终端Git、编辑器中文支持

🔍 资源端点

文档资源

godot://script/current - 当前打开的脚本
godot://scene/current - 当前打开的场景
godot://project/info - 项目元数据和设置

资源搜索

godot://scripts/list - 脚本列表
godot://scenes/list - 场景列表
godot://resources/list - 资源列表

🛠️ 将插件添加到您的Godot项目

如果您想在Godot项目中使用MCP插件：

将addons/godot_mcp翻译成英文的文件夹复制到您的项目的addons目录
在Godot中打开项目
转到项目>项目设置>插件
启用“Godot MCP”插件

🔧 故障排除

连接问题

确保在Godot的项目设置中启用了插件
检查Godot控制台中的错误消息
确认Claude Desktop启动时服务器正在运行

技能不起作用

检查.claude/skills/目录是否有技能文件
确认技能文件格式正确（包括YAML前言）
验证MCP工具是否配置并正常运行

兼容性问题

使用detect_godot_version工具检查项目版本
运行`check_god