Check out our latest project ✨ OpenChapter.io: free ebooks the way its meant to be 📖

GDMCP

An asset by theLegend35
The page banner background of a mountain and forest

Quick Information

No ratings yet
GDMCP icon image
theLegend35
GDMCP

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

Supported Engine Version
4.2
Version String
1.1.0
Support Level
community
Modified Date
4 hours ago
Git URL
Issue URL
Download ZIP

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)

  1. Open the GDMCP bottom panel → Settings
  2. Pick a provider (Claude / OpenAI / Gemini / OpenAI-compatible)
  3. Paste your API key → Save settings
  4. 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

0 total reviews
No ratings yet

Your Rating

How do you rate this asset?
Headline must be at least 3 characters but not more than 50
Review must be at least 5 characters but not more than 500
Please sign in to add a review

Quick Information

No ratings yet
GDMCP icon image
theLegend35
GDMCP

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

Supported Engine Version
4.2
Version String
1.1.0
Support Level
community
Modified Date
4 hours ago
Git URL
Issue URL
Download ZIP

Open Source

Released under the AGPLv3 license

Plug and Play

Browse assets directly from Godot

Community Driven

Created by developers for developers