Better Godot MCP

Name: Better Godot MCP
Author: n24q02m

mcp-name: io.github.n24q02m/better-godot-mcp

用于 Godot Engine 的复合 MCP 服务器 -- 17 个助力 AI 辅助游戏开发的超级工具

codecov npm Docker License: MIT

TypeScript Node.js Godot Engine semantic-release Renovate

功能

17 个复合超级工具 -- 场景、节点、脚本、着色器、动画、TileMap、物理、音频、导航、UI 等
完整的场景控制 -- 无需运行 Godot 即可直接创建、解析和修改 .tscn 文件
GDScript CRUD -- 在单次调用中创建、读取、写入和附加脚本
分层 Token 优化 -- 压缩描述 + 按需 help 工具

Related MCP server: WET - Web Extended Toolkit

设置

使用 AI Agent -- 复制并发送此内容给您的 AI Agent：

请为我设置 @n24q02m/better-godot-mcp。请遵循此指南： https://raw.githubusercontent.com/n24q02m/better-godot-mcp/main/docs/setup-with-agent.md

手动设置 -- 请遵循 docs/setup-manual.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 检测（环境变量、PATH、常见位置）
项目验证 -- 在操作前验证 project.godot 是否存在
跨平台 -- Windows、macOS、Linux 路径处理

从源码构建

git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev

许可证

MIT -- 参见 LICENSE。

Install Server

A

security – no known vulnerabilities

A

license - permissive license

B

quality - B tier

How are these scores calculated?

Resources

Need Help?

Related Servers

Tools

View all tools

Better Godot MCP

Better Godot MCP

功能

设置

工具

配置

限制

安全性

从源码构建

许可证

Resources

Tools

Latest Blog Posts

MCP directory API