Back to Browse
Free
Server data from the Official MCP Registry
MCP server for Godot Engine 4.x with 17 tools for scenes, scripts, and shaders.
About
MCP server for Godot Engine 4.x with 17 tools for scenes, scripts, and shaders.
Security Report
10.0
Low Risk10.0Low RiskValid MCP server (5 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry. Trust signals: trusted author (8/8 approved).
18 tools verified · Open access · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Default Godot project path. Most tools also accept project_path parameter.
Environment variable: GODOT_PROJECT_PATH
Path to Godot binary. Auto-detected if not set.
Environment variable: GODOT_PATH
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-n24q02m-better-godot-mcp": {
"env": {
"GODOT_PATH": "your-godot-path-here",
"GODOT_PROJECT_PATH": "your-godot-project-path-here"
},
"args": [
"-y",
"@n24q02m/better-godot-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
Better Godot MCP
mcp-name: io.github.n24q02m/better-godot-mcp
Composite MCP server for Godot Engine -- 17 mega-tools for AI-assisted game development
Features
- 17 composite mega-tools -- scene, node, script, shader, animation, tilemap, physics, audio, navigation, UI, and more
- Full scene control -- create, parse, and modify
.tscnfiles directly without Godot running - GDScript CRUD -- create, read, write, and attach scripts in a single call
- Tiered token optimization -- compressed descriptions + on-demand
helptool
Setup
With AI Agent -- copy and send this to your AI agent:
Please set up @n24q02m/better-godot-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-godot-mcp/main/docs/setup-with-agent.md
Manual Setup -- follow docs/setup-manual.md
Tools
| Tool | Actions | Description |
|---|---|---|
project | info, version, run, stop, settings_get, settings_set, export | Project metadata, run/stop, and settings |
scenes | create, list, info, delete, duplicate, set_main | Scene file management |
nodes | add, remove, rename, list, set_property, get_property | Scene tree node manipulation |
scripts | create, read, write, attach, list, delete | GDScript file CRUD |
editor | launch, status | Launch Godot editor and check status |
config | status, set, detect_godot, check | Server configuration and environment detection |
resources | list, info, delete, import_config | Resource file management |
input_map | list, add_action, remove_action, add_event | Input action and event mapping |
signals | list, connect, disconnect | Signal connections |
animation | create_player, add_animation, add_track, add_keyframe, list | Animation players and tracks |
tilemap | create_tileset, add_source, set_tile, paint, list | TileMap and TileSet management |
shader | create, read, write, get_params, list | Shader file CRUD with Godot 4 syntax |
physics | layers, collision_setup, body_config, set_layer_name | Collision layers and physics bodies |
audio | list_buses, add_bus, add_effect, create_stream | Audio bus and effect management |
navigation | create_region, add_agent, add_obstacle | Navigation regions, agents, and obstacles |
ui | create_control, set_theme, layout, list_controls | UI control creation and theming |
help | - | Get full documentation for any tool |
Configuration
Godot binary is auto-detected from common install locations and PATH. No environment variables are required for basic usage. Optionally set GODOT_PROJECT_PATH and GODOT_PATH to override defaults.
| Variable | Required | Default | Description |
|---|---|---|---|
GODOT_PROJECT_PATH | No | - | Default project path (tools also accept project_path param) |
GODOT_PATH | No | Auto-detected | Path to Godot binary |
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)
Security
- Binary detection -- Multi-path Godot detection (env, PATH, common locations)
- Project validation -- Verifies project.godot exists before operations
- Cross-platform -- Windows, macOS, Linux path handling
Build from Source
git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev
License
MIT -- See LICENSE.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
3
Installs
6.8
Security
No ratings yet
Local
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
80.0K
Stars
3
Installs
7.1
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
399
Installs
10.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
55
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
89.9K
Stars
13
Installs
8.5
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
13
Installs
10.0
Security
5.0
Local