Godot Native MCP (SSE)

✨ Zero-Dependency & Built-in GUI Setup

Most MCP plugins force you to install Node.js/NPM, compile TS files, and configure terminal routers.godot-mcpworks differently:

- Zero CLI Friction: Runs entirely inside your Godot Editor via a lightweight built-in HTTP server.
- One-Click IDE Configuration: Includes an in-editor docking panel that can instantly write configuration files forCursororTraewith a single click, or copy the exact CLI installation config strings forClaude Desktop / Claude Code.
- Visual Control Hub: Switch tools, monitor local server live-logs, and control connection ports (Default:3000) directly within Godot's UI interface.

┌────────────────────────────────────────────────────────┐ │ ](https://github.com/DaxianLee/godot-mcp)[ Godot Editor Panel ] │ │ ┌───────────────┐ ┌────────────────┐ ┌───────────────┐ │ │ │ Server Logs │ │ Tools Status │ │ Config (IDE) │ │ │ ├───────────────┴ └────────────────┴ ───────────────┤ │ │ │ Host IP: 127.0.0.1 [Start Server] [Stop] │ │ │ │ Selected IDE: [ Cursor / Trae / Claude Desktop ] │ │ │ │ >> [ONE-CLICK CONFIG] << │ │ │ └────────────────────────────────────────────────────┘ │ └────────────────────────────────────────────────────────┘

Once connected, your AI agents (Claude, Cursor, Trae, ChatGPT) gain access to a powerful set of tools to interact with your active Godot project directory. The server exposes the following functions:

- scene_create(path, root_node_type): Generates a new.tscnscene resource programmatically.
- scene_open(path): Automatically opens, matches, and focuses the viewport on a target scene in the editor.
- scene_save(): Triggers a live-saving event of the current working scene.
- get_scene_tree(path): Exposes the full, parsed node tree structure of a target scene to the LLM context.
- get_scene_info(path): Returns metadata, external dependencies (resources), and inspector details of a scene.

- read_gdscript(path): Safely loads any.gdfile into the AI's window for inspection.
- write_gdscript(path, code): Writes or modifies full GDScript code, fully supported with auto-formatting and syntax validation.
- modify_gdscript(path, modifications): Appends, replaces, or structures specific blocks of an active GDScript without rewriting the entire file.

- get_godot_state(): Fetches global editor context, window structures, selected nodes, and active build options.
- execute_editor_command(command): Allows the agent to instruct the parent system to build project files, compile assets, or run/stop the active game scene.
- Copy theaddons/godot_mcpfolder into your Godot project'sres://addons/directory.
- In Godot, navigate toProject -> Project Settings -> Pluginsand check theEnablebox forGodot MCP Server.
- Open theGodotMCPpanel in the editor dock.
- ClickStart Serverand confirm the server is running on port3000.

Option A: Cursor / Trae (Dynamic Built-in Panel Setup)

Copy the configuration below to yourclaude_desktop_config.jsonmanually if desired:

{ "mcpServers": { "godot-mcp": { "command": "curl", "args": ["-s", "http://127.0.0.1:3000/mcp"], "transport": "http" } } }

WhileGodot MCPis 100% free and open-source under the MIT license, we specialize in building professional AI-native game design environments. If you are developing on other platforms or need enterprise-class automated workspaces, explore our customized pro-grade engines:

Learn more and start your free trials atvberai.com.

- If you encounter an issue or want to suggest new Godot API tools, please open anIssue.
- For corporate inquires and licensing regarding Cocos/Unity products, email us at: info [at] vberai.com.

This repository is licensed under the MIT License - see theLICENSEfile for details.

Local stdio MCP server that lets AI coding agents read and maintain structured architecture, rules, and decisions directly from your repository.