中文版本

Model Context Protocol(MCP)을 통해 AI 어시스턴트(Claude 등)를 통합하는 강력한 Godot 엔진 플러그인입니다. 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.