更好的Godot MCP
mcp名称:io.github.n24q02m/better-godot-mcp
Godot引擎的复合MCP服务器——用于AI辅助游戏开发的17大工具
  ](https://www.npmjs.com/package/@n24q02m/better-godot-mcp) ](https://hub.docker.com/r/n24q02m/better-godot-mcp) 
 ](#)   
Sister projects from n24q02m (click to expand)
| 项目 | 标记线 | 标记 |
|---|---|---|
| 更好的代码审查图 | 用于令牌高效代码审查的知识图——固定搜索,可配置。.. | MCP |
| 更好的电子邮件mcp | 用于AI代理的IMAP/SMTP电子邮件服务器——6个具有多帐户的复合工具。.. | MCP |
| 更好的godot-mcp | Godot引擎的复合MCP服务器——用于AI辅助游戏开发的17大工具 | MCP |
| 更好的概念mcp | Markdown第一个用于人工智能代理的Notion API服务器——10个复合工具replacin。.. | MCP |
| 更好的电报mcp | 用于Telegram的MCP服务器,支持双模:用于快速聊天的Bot API(httpx)… | MCP |
| claude插件 | 完整文档:mcp.n24q02m.com——所有8台服务器+mc的统一文档 | |
| 想象一下mcp | 用于图像和视频理解+生成交流的生产级MCP服务器 | MCP |
| jules任务归档员 | Chrome扩展通过批执行API对Jules任务进行批量操作--a… | 工具 |
| mcp核心 | 统一MCP流式HTTP 2025-11-25传输,OAuth 2.1授权序列。.. | MCP |
| mnemo mcp | 具有混合搜索和嵌入式同步功能的持久AI内存。开放、自由、无趣。.. | MCP |
| qwen3嵌入 | 通过ONNX Runtime和GGUF | 库进行轻量级Qwen3文本嵌入和重新排序 |
| 尖叫 | 没有服务器的秘密。 | CLI |
| 网络核心 | 用于搜索、抓取、HTTP安全和存储的共享web基础架构包 | 库 |
| 湿mcp | 用于网络搜索、内容提取、库文档和多媒体的开源MCP服务器 | MCP |
目录
特性
- 17个复合巨型工具 --场景、节点、脚本、着色器、动画、tilemap、物理、音频、导航、UI等
- 全场景控制 --创建、解析和修改
.tscn无需运行Godot即可直接运行文件 - GDScript CRUD --在一次调用中创建、读取、写入和附加脚本
- 分层令牌优化 --压缩描述+按需
help工具
状态
2026-05-02——架构稳定更新 过去几个月,凭证处理和守护进程桥自动生成模式发生了重大变化。这导致了多进程竞争、浏览器标签垃圾邮件和插件之间不一致的设置用户体验。 从v\开始,架构是稳定的:2种干净模式(stdio+HTTP),没有守护进程桥层,没有从stdio自动生成。 为不稳定时期道歉。如果您在以前的版本中遇到问题,请更新到v\+并遵循当前版本 docs/setup-manual.md --不再需要大多数先前的解决方法。 来自同一作者的相关插件: - 湿mcp --网络搜索+内容提取 - mnemo mcp --持久AI记忆 - 想象一下mcp --图像/视频理解+生成 - 更好的概念mcp --API通知 - 更好的电子邮件mcp --电子邮件管理 - 更好的电报mcp --电报 - 更好的godot-mcp --Godot引擎 - 更好的代码审查图 --代码审查知识图 所有插件共享相同的架构——安装一次,学习模式转换。文档
完整文档请访问 mcp.n24q02m.com/servers/better-godot-mcp/:
- 设置 --Claude Code、Codex、Gemini CLI、Cursor、Windsurf、mcp.json的安装方法
- 模式概述 --stdio/本地中继/远程中继/远程oauth
- 多用户设置 --根据JWT子证书模型
使用AI代理进行安装 --将此粘贴到您的AI编码代理:
安装MCP服务器 better-godot-mcp 按照以下步骤\ https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-godot-mcp/setup-with-agent.md工具
| 工具 | 操作 | 描述 |
|---|---|---|
project | info, version, run, stop, settings_get, settings_set, export | 项目元数据、运行/停止和设置 |
scenes | create, list, info, delete, duplicate, set_main | 场景文件管理 |
nodes | add, remove, rename, list, set_property, get_property | 场景树节点操作 |
scripts | create, read, write, attach, list, delete | GDScript文件CRUD |
editor | launch, status | 启动Godot编辑器并检查状态 |
config | status, set, detect_godot, check | 服务器配置和环境检测 |
resources | list, info, delete, import_config | 资源文件管理 |
input_map | list, add_action, remove_action, add_event | 输入动作和事件映射 |
signals | list, connect, disconnect | 信号连接 |
animation | create_player, add_animation, add_track, add_keyframe, list | 动画播放器和曲目 |
tilemap | create_tileset, add_source, set_tile, paint, list | TileMap和TileSet管理 |
shader | create, read, write, get_params, list | 使用Godot 4语法的着色器文件CRUD |
physics | layers, collision_setup, body_config, set_layer_name | 碰撞层和物理体 |
audio | list_buses, add_bus, add_effect, create_stream | 音频总线和效果管理 |
navigation | create_region, add_agent, add_obstacle | 导航区域、代理和障碍物 |
ui | create_control, set_theme, layout, list_controls | UI控件创建和主题化 |
help | - | 获取任何工具的完整文档 |
配置
Godot二进制文件是从常见安装位置自动检测到的 PATH。基本使用不需要环境变量。可选设置 GODOT_PROJECT_PATH 和 GODOT_PATH 以覆盖默认值。
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
GODOT_PROJECT_PATH | 否 | - | 默认项目路径(也接受工具 project_path 参数) |
GODOT_PATH | 否 | 自动检测 | Godot二进制文件的路径 |
局限性
- 需要Godot 4.x项目结构
- 场景文件(
.tscn)通过文本操作进行解析/修改,而不是Godot的内部API run/stop/export操作需要安装Godot二进制文件- Docker模式具有有限的文件系统访问权限(挂载项目目录)
安全
- 二进制检测 --多路径Godot检测(环境、路径、公共位置)
- 项目验证 --在操作之前验证project.godot是否存在
- 跨平台 --Windows、macOS、Linux路径处理
从源代码构建
git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev信任模型
此插件实现 TC本地 (不需要身份验证——不存储凭据)。看 mcp核心/docs/TRUST-MODEL.md 进行全面分类。
| 模式 | 存储 | 加密 | 谁可以读取您的数据? |
|---|---|---|---|
| stdio(默认) | N/A(无凭据) | N/A | N/A |
| HTTP自主机 | N/A(无凭据) | N/A | N/A |
许可证
麻省理工学院——见 许可证.
