n24q02m/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

CI codecov npm Docker License: MIT

TypeScript Node.js Godot Engine semantic-release Renovate

Sister projects from n24q02m (click to expand)

Project	Tagline	Tag
better-code-review-graph	Knowledge graph for token-efficient code reviews -- fixed search, configurabl...	MCP
better-email-mcp	IMAP/SMTP email server for AI agents -- 6 composite tools with multi-account ...	MCP
better-godot-mcp	Composite MCP server for Godot Engine -- 17 mega-tools for AI-assisted game d...	MCP
better-notion-mcp	Markdown-first Notion API server for AI agents -- 10 composite tools replacin...	MCP
better-telegram-mcp	MCP server for Telegram with dual-mode support: Bot API (httpx) for quick bot...	MCP
claude-plugins	Full documentation: mcp.n24q02m.com — unified docs for all 8 servers + the mc...	Marketplace
imagine-mcp	Production-grade MCP server for image and video understanding + generation ac...	MCP
jules-task-archiver	Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a...	Tooling
mcp-core	Unified MCP Streamable HTTP 2025-11-25 transport, OAuth 2.1 Authorization Ser...	MCP
mnemo-mcp	Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi...	MCP
qwen3-embed	Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF	Library
skret	Secrets without the server.	CLI
web-core	Shared web infrastructure package for search, scraping, HTTP security, and st...	Library
wet-mcp	Open-source MCP Server for web search, content extraction, library docs & mul...	MCP

Table of contents

• Features
• Status
• Documentation
• Tools
• Configuration
• Security
• Build from Source
• Trust Model
• License

Features

• 17 composite mega-tools -- scene, node, script, shader, animation, tilemap, physics, audio, navigation, UI, and more
• Full scene control -- create, parse, and modify .tscn files directly without Godot running
• GDScript CRUD -- create, read, write, and attach scripts in a single call
• Tiered token optimization -- compressed descriptions + on-demand help tool

Status

2026-05-02 -- Architecture stabilization update

Past months saw significant churn around credential handling and the daemon-bridge auto-spawn pattern. This caused multi-process races, browser tab spam, and inconsistent setup UX across plugins. As of v<auto>, the architecture is stable: 2 clean modes (stdio + HTTP), no daemon-bridge layer, no auto-spawn from stdio.

Apologies for the instability period. If you encountered issues with prior versions, please update to v<auto>+ and follow the current Setup guide -- most prior workarounds are no longer needed.

Related plugins from the same author:

• wet-mcp -- Web search + content extraction
• mnemo-mcp -- Persistent AI memory
• imagine-mcp -- Image/video understanding + generation
• better-notion-mcp -- Notion API
• better-email-mcp -- Email management
• better-telegram-mcp -- Telegram
• better-godot-mcp -- Godot Engine
• better-code-review-graph -- Code review knowledge graph

All plugins share the same architecture -- install once, learn pattern transfers.

Documentation

Full docs at mcp.n24q02m.com/servers/better-godot-mcp/:

• Setup -- install methods for Claude Code, Codex, Gemini CLI, Cursor, Windsurf, mcp.json
• Modes overview -- stdio / local-relay / remote-relay / remote-oauth
• Multi-user setup -- per-JWT-sub credential model

Install with AI agent -- paste this to your AI coding agent:

Install MCP server better-godot-mcp following the steps at
https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-godot-mcp/setup-with-agent.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/export actions 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

Trust Model

This plugin implements TC-Local (no auth required -- no credentials stored). See mcp-core/docs/TRUST-MODEL.md for full classification.

Mode	Storage	Encryption	Who can read your data?
stdio (default)	N/A (no credentials)	N/A	N/A
HTTP self-host	N/A (no credentials)	N/A	N/A

License

MIT -- See LICENSE.