The Gear server is an MCP server embedded in the Godot editor that gives AI clients programmatic control over Godot 4 projects through 109 tools across 26 domains.
Project Management: List, open, and inspect Godot projects; read/write project settings; search project files for text or regex patterns.
Editor Control: Launch the Godot editor GUI, run/stop projects, capture debug output, check editor connection status, and query the installed Godot version.
Scene Editing: Create/save/inspect scenes; add, delete, move, and configure nodes (full ClassDB support); set node properties with type conversion (Vector2, Color, etc.); connect signals between nodes.
Scripting: Create GDScripts with templates (singleton, state_machine, component, resource), modify existing scripts (add functions/variables/signals), and analyze script structure.
Class & Resource Introspection: Query Godot classes from ClassDB; get detailed info on methods, properties, signals, and enums; analyze resource dependencies and detect circular references.
Export & Build: List export presets and build distributable executables for multiple platforms.
Runtime & Debugging: Monitor live game instances; access LSP diagnostics, DAP console output; manage breakpoints and step-through debugging.
Project Visualization: Generate interactive browser-based visual maps of all scripts, connections, and project structure.
Asset Downloads: Pull CC0 assets from Poly Haven, AmbientCG, and Kenney.
Testing & DX: Inject inputs, take screenshots, run headless, assert logs, snapshot sessions, and track development intent.
Dynamic Tool Groups: Activate on-demand tool groups covering animations, tilemaps, audio, navigation, theming, autoloads, plugins, UID handling, and more.
Tool Discovery: Search and catalog all available tools by keyword, with auto-activation of matching dynamic groups.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Gear create a new scene with a CharacterBody2D root node"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Gear allows AI assistants to directly run, inspect, modify, and debug your Godot projects.
Godot 4.x
Node.js 18+
MCP-supported client (Claude Desktop, Cursor, Cline, etc.)
npx -y gearOr install globally:
npm install -g gear-godot-mcp
gearAdd the following to your client's configuration file (e.g., Claude Desktop):
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["-y", "gear"],
"env": {
"GODOT_PATH": "/path/to/godot"
}
}
}
}"List all Godot projects in the /your/projects directory"
"Create scenes/Player.tscn with a CharacterBody2D root node"
"Run the project, get debug output, and fix the errors"
Related MCP server: Godot MCP Enhanced
Feature | Description |
Real-time Feedback | Run games, check logs, and fix issues instantly |
110+ Tools | Covers scenes/scripts/resources/runtime/LSP/debugging/input/assets |
Token Efficient | Only 33 core tools exposed by default; activate others on demand |
Dynamic Tool Groups | Automatically activate relevant tool groups when searching for tools |
Deep Integration | ClassDB queries, runtime inspection, and breakpoint debugging |
✅ Indie developers using AI to accelerate development
✅ Teams needing AI to understand real project/runtime states
✅ Heavy debugging workflows (breakpoints, stack traces, runtime inspection)
Gear has three tool exposure modes:
Mode | Tool Count | Description |
| 33 core + 78 on-demand | Token efficient, loaded on demand |
| 110+ | All tools exposed |
| 110+ | Same as full |
compact ModeIn compact mode, the 78 additional tools are organized into 22 dynamic tool groups:
Tool Group | Tool Count | Description |
| 3 | Node duplication, reparenting, loading sprites |
| 4 | Runtime scene inspection, property modification |
| 6 | Breakpoints, stepping, stack traces |
| 3 | Code completion, hover, symbol list |
| 6 | Screenshots, input injection |
| 5 | Animations, tracks, state machines |
| 4 | Materials, shaders, resource creation |
... | ... | And more |
1. Auto-activation (Recommended)
Use
tool.catalogto search for relevant tools; matching tool groups will activate automatically
2. Manual Activation
Use
tool.groupsto manually activate specific tool groups "Activate thedaptool group for debugging"
3. Deactivation
Use
tool.groupsto reset activated groups
npx -y gearnpm install -g gear-godot-mcp
geargit clone https://github.com/HaD0Yun/Gear-godot-mcp.git
cd Gear-godot-mcp
npm install
npm run build
node build/index.jsCreate scenes, add/delete nodes
Modify node properties
Node reparenting
Create/modify scripts
Analyze script structure
Symbol renaming
Inspect runtime scene tree
Set breakpoints, step through code
View variable values
Inject keyboard/mouse input
Capture game screen
Viewport capture
Search CC0 assets (Poly Haven, AmbientCG, Kenney)
Download resources to project
Variable | Purpose | Default Value |
| Tool exposure mode |
|
| Path to Godot executable | Auto-detected |
| Bridge service port |
|
| Tool list page size |
|
| Debug logs |
|
Issue | Solution |
Godot not found | Set |
Tool list empty | Restart MCP client |
Invalid project path | Confirm |
Runtime tools not working | Install and enable the runtime addon plugin |
Tool not found | Use |
MIT — See LICENSE for details.
Original MCP server from Coding-Solo
Gear enhancements developed by HaD0Yun
Project visualization features inspired by tomyud1/godot-mcp
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
An MCP server that gives your AI access to the source code and docs of all public github repos
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wvfp/gear-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server