中文版本

一个强大的Godot引擎插件，通过模型上下文协议（MCP）集成了AI助手（Claude等）。使AI能够通过自然语言直接读取和修改你的Godot项目——场景、脚本、节点和资源。

🚀 特色

• 完整项目访问：AI助手可以读取并修改脚本、场景、节点和资源
• 原生实现：无需Node.js依赖——完全运行在 Godot 内部
• 实时编辑：直接在编辑器中应用AI建议
• 综合工具集（155个工具 — 30个核心工具+125个辅助工具）：
• 节点工具（9个核心+11个高级）：创建、修改、管理场景节点、复制、移动、重命名、信号连接、锚点预设、组管理、批处理操作、场景审计
• 脚本工具（7核心 + 8高级）：编辑、分析、创建、附加、验证GDScript和C#文件、脚本执行、文件搜索、符号索引、定义和引用查找
• 场景工具（4个核心 + 4个高级）：操作场景结构、保存场景、列表/打开/关闭场景标签页、项目场景列表

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.

# 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.