A simple branching dialogue editor and stateless runtime.Create your dialogue right in the Godot Editor itself with a simple script-like language and the built-in syntax checker.Then, in your game, use the DialogueManager global to fetch lines of dialogue. There is an example dialogue balloon to help get you started on creating your own to fit in better with your game. The GitHub repository also contains a few extra example balloon implementations.
Quick Information
GDMCP is a Godot 4 editor plugin that connects AI agents to your project through the Model Context Protocol (MCP).Use it with Cursor, Claude Desktop, or other MCP clients to inspect and edit scenes, nodes, scripts, and files. It also includes an optional in-editor chat panel that works with Anthropic (Claude), OpenAI, Google Gemini, and OpenAI-compatible providers using your own API keys.Features:- Localhost MCP WebSocket bridge for AI tools- Scene tree inspection and undoable node edits- Read/write project files and attach scripts- Run/stop the project from the agent- Optional in-editor AI chat with multiple providersRequires Godot 4.2+. The optional Cursor/Claude MCP server needs Node.js 20+.Author: Dhruv VineshLicense: MIT
Godot + MCP + in-editor AI by Dhruv Vinesh
Let Cursor, Claude, and other AI agents control your Godot 4 editor — or chat from inside Godot with your own API keys (Claude, OpenAI, Gemini, OpenRouter, …).
Option A: Cursor / Claude Desktop --stdio MCP--> Node server --WebSocket--> Godot
Option B: Type in GDMCP Chat tab --HTTPS------> Claude / OpenAI / Gemini --> same tools
Requirements
- Godot 4.2+ (GDScript)
- Node.js 20+ (only if using Cursor/Claude MCP bridge)
- Optional: API keys from Anthropic, OpenAI, Google, or an OpenAI-compatible host
Install
1. Enable the Godot addon
Copy addons/gdmcp into your game (or open this repo in Godot).
Project → Project Settings → Plugins → GDMCP → Enable
2. Chat from Godot (API keys)
- Open the GDMCP bottom panel → Settings
- Pick a provider (Claude / OpenAI / Gemini / OpenAI-compatible)
- Paste your API key → Save settings
- Go to Chat, ask it to inspect or edit the project
Keys are stored in Editor Settings (your machine), not in the game repo.
3. Optional: Cursor MCP bridge
cd GDMCP
npm run prepare:mcp
Point Cursor MCP at mcp-server/dist/index.js (see examples/cursor-mcp.json).
Providers
| Provider | Notes |
|---|---|
| Anthropic (Claude) | Messages API + tools |
| OpenAI | Chat Completions + tools |
| Google Gemini | generateContent + function calling |
| OpenAI-compatible | OpenRouter, Groq, Ollama, etc. Set base URL |
Tools
Same tool surface for Chat and MCP: scene tree, nodes, files, play/stop, and more. Scene mutations are undoable (Ctrl+Z).
Config
Editor Settings (AI) — configured in the GDMCP Settings tab
Project settings (bridge) — gdmcp/network/port (default 6505), gdmcp/network/autostart
The WebSocket MCP bridge binds to localhost only.
Safety
GDMCP can modify scenes and files. API keys never leave your editor except to the provider you chose. Only use keys you control.
Author
Dhruv Vinesh
License
MIT — see LICENSE
GDMCP is a Godot 4 editor plugin that connects AI agents to your project through the Model Context Protocol (MCP). Use it with Cursor, Claude Desktop, or other MCP clients to inspect and edit scenes, nodes, scripts, and files. It also includes an optional in-editor chat panel that works with Anthropic (Claude), OpenAI, Google Gemini, and OpenAI-compatible providers using your own API keys. Features: - Localhost MCP WebSocket bridge for AI tools - Scene tree inspection and undoable node edits - Read/write project files and attach scripts - Run/stop the project from the agent - Optional in-editor AI chat with multiple providers Requires Godot 4.2+. The optional Cursor/Claude MCP server needs Node.js 20+. Author: Dhruv Vinesh License: MIT
Reviews
Quick Information
GDMCP is a Godot 4 editor plugin that connects AI agents to your project through the Model Context Protocol (MCP).Use it with Cursor, Claude Desktop, or other MCP clients to inspect and edit scenes, nodes, scripts, and files. It also includes an optional in-editor chat panel that works with Anthropic (Claude), OpenAI, Google Gemini, and OpenAI-compatible providers using your own API keys.Features:- Localhost MCP WebSocket bridge for AI tools- Scene tree inspection and undoable node edits- Read/write project files and attach scripts- Run/stop the project from the agent- Optional in-editor AI chat with multiple providersRequires Godot 4.2+. The optional Cursor/Claude MCP server needs Node.js 20+.Author: Dhruv VineshLicense: MIT