Godot MCP Native

Godot MCP Native (Model Context Protocol)

中文版本

A powerful Godot Engine plugin that integrates AI assistants (Claude, etc.) via the Model Context Protocol (MCP). Enable AI to directly read and modify your Godot projects - scenes, scripts, nodes, and resources - all through natural language.

🚀 Features

- Full Project Access: AI assistants can read and modify scripts, scenes, nodes, and resources
- Native Implementation: No Node.js dependency required - runs entirely within Godot
- Real-time Editing: Apply AI suggestions directly in the editor
- Comprehensive Tool Set (155 tools — 30 core + 125 supplementary):
  - Node Tools (9 core + 11 advanced): Create, modify, manage scene nodes, duplicate, move, rename, signal connections, anchor presets, group management, batch operations, scene auditing
  - Script Tools (7 core + 8 advanced): Edit, analyze, create, attach, validate GDScript and C# files, execute scripts, search in files, symbol indexing, definition & reference lookup
  - Scene Tools (4 core + 4 advanced): Manipulate scene structure, save scenes, list/open/close scene tabs, project scene listing
  - Editor Tools (4 core + 12 advanced): Control editor functionality, screenshot, signal inspection, filesystem reload, node/file selection, export management, property inspector
  - Debug Tools (3 core + 68 advanced): Logging, debugger sessions, breakpoints, stack/variable inspection, profilers, runtime probe, animation/audio/shader/tilemap runtime control, debug execution control, await_scene_ready
  - Project Tools (3 core + 23 advanced): Access project settings, list resources, create resources, run tests, manage input mappings, inspect autoloads/global classes, resource diagnostics & health audit

🖥️ gdmcp CLI (Agent-First Interface)

For coding agents (Codex, Claude Code, Cursor) that have shell access, the gdmcp CLI
is the recommended way to interact with Godot MCP. Instead of loading all 155 tool
schemas into model context, the CLI uses progressive discovery — ~33 domain commands
for common operations, and on-demand schema retrieval for supplementary tools.

bash
Quick start
gdmcp --json doctor
gdmcp --json scenes tree --depth 4
gdmcp --json scripts read res://player.gd --lines 1:200
gdmcp --json nodes properties set /root/Player --property speed --value 300

Installation: Open the Godot editor → MCP dock → CLI Tools tab, or download
from GitHub Releases.
See the CLI README and CLI Reference
for full documentation.

Skill: Install the companion Codex skill from skills/gdmcp/ to teach your
agent the CLI workflow. Copy skills/gdmcp/ to ~/.codex/skills/gdmcp/.

📦 Installation

Method 1: Asset Library (Recommended)
1. Open your Godot project
2. Go to AssetLib tab in the editor
3. Search for "Godot MCP Native"
4. Click Download and then Install

Method 2: Manual Installation
1. Download or clone this repository
2. Copy the addons/godot_mcp folder to your project's addons/ directory
3. Open your project in Godot
4. Go to Project > Project Settings > Plugins
5. Enable "Godot MCP Native" plugin

🔧 Usage

Enabling the Plugin
1. Open Project > Project Settings > Plugins
2. Locate "Godot MCP Native" in the list
3. Set the status to Enable

Co

……（后略，见原文）