Skip to main content
Glama
n24q02m

Better Godot MCP

by n24q02m

Better Godot MCP

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

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

CI 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: Better Notion MCP

设置

使用 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_PATHGODOT_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
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
1dResponse time
2dRelease cycle
93Releases (12mo)
Commit activity
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Discover AI tools for game development — 100+ tools indexed by engine, task, and pricing.

  • Deterministic AI agent microtools, no accounts/API keys. fetch_extract: 98% token cut. 38 tools.

  • Generate game assets with AI: sprites, 3D models, animations, sound effects, music, and voices.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/n24q02m/better-godot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server