📦
io.github.n24q02m/better-godot-mcp
MCP server for Godot Engine 4.x with 18 tools for scenes, scripts, and shaders.
0 installs
Trust: 37 — Low
Devtools
Ask AI about io.github.n24q02m/better-godot-mcp
Powered by Claude · Grounded in docs
I know everything about io.github.n24q02m/better-godot-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Better Godot MCP
Composite MCP Server for Godot Engine - Optimized for AI Agents
Why "Better"?
18 composite tools that consolidate Godot Engine operations into action-based mega-tools optimized for AI agents.
Key Features
| Feature | Description |
|---|---|
| Composite Actions | 1 tool call instead of multiple steps |
| Full Scene Control | Create, parse, modify .tscn files directly |
| GDScript CRUD | Create, read, write, attach scripts |
| Shader Support | Create, edit shaders with Godot 4 syntax |
| Input Mapping | Manage input actions and events |
| Physics/Audio/Nav | Configure collision layers, audio buses, navigation |
| Token Efficient | Tiered descriptions with on-demand help tool |
Quick Start
Option 1: Package Manager (Recommended)
{
"mcpServers": {
"better-godot": {
"command": "bun",
"args": ["x", "@n24q02m/better-godot-mcp@latest"]
}
}
}
Alternatively, you can use npx, pnpm dlx, or yarn dlx:
| Runner | command | args |
|---|---|---|
| npx | npx | ["-y", "@n24q02m/better-godot-mcp@latest"] |
| pnpm | pnpm | ["dlx", "@n24q02m/better-godot-mcp@latest"] |
| yarn | yarn | ["dlx", "@n24q02m/better-godot-mcp@latest"] |
Option 2: Docker
{
"mcpServers": {
"better-godot": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"--name", "mcp-godot",
"n24q02m/better-godot-mcp:latest"
]
}
}
}
Note: Project path is passed via tool parameters (
project_path), not environment variables.
Tools
| Tool | Actions |
|---|---|
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 |
editor | launch, status |
setup | detect_godot, check |
config | status, set |
help | Get full documentation for any tool |
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 |
shader | create, read, write, get_params, list |
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 |
Token Optimization
Tiered descriptions for efficient token usage:
| Tier | Purpose | When |
|---|---|---|
| Tier 1 | Compressed descriptions | Always loaded |
| Tier 2 | Full docs via help tool | On-demand |
{"name": "help", "tool_name": "scenes"}
Environment Variables
| Variable | Required | Description |
|---|---|---|
GODOT_PROJECT_PATH | No | Default project path (most tools accept project_path param) |
GODOT_PATH | No | Path to Godot binary (auto-detected if not set) |
Limitations
- Requires Godot 4.x project structure
- Scene files (
.tscn) are parsed/modified via text manipulation, not Godot's internal API run/stop/exportactions require Godot binary to be installed- Docker mode has limited filesystem access (mount your project directory)
Build from Source
git clone https://github.com/n24q02m/better-godot-mcp
cd better-godot-mcp
mise run setup
bun run build
Requirements: Node.js 24+, bun latest
Compatible With
Also by n24q02m
| Server | Description | Install |
|---|---|---|
| better-notion-mcp | Notion API for AI agents | npx -y @n24q02m/better-notion-mcp@latest |
| wet-mcp | Web search, content extraction, library docs | uvx --python 3.13 wet-mcp@latest |
| mnemo-mcp | Persistent AI memory with hybrid search | uvx mnemo-mcp@latest |
| better-email-mcp | Email (IMAP/SMTP) for AI agents | npx -y @n24q02m/better-email-mcp@latest |
Contributing
See CONTRIBUTING.md
License
MIT - See LICENSE
