YG

yanhuifair/godot-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

49 stars 6 forks 품질 90 트렌드 27AGPL-3.0

aI Assistant를 연결하는 모델 Context Protocol 서버입니다. — 직접 . AI는 프로젝트에 대해 추측하고 운영을 시작합니다.

개요

aI Assistant를 연결하는 모델 Context Protocol 서버입니다. — 직접 . AI는 프로젝트에 대해 추측하고 운영을 시작합니다. - ts — .tscn 장면, .tres 자원, GDScript, C#, .gdshader, project.godot. 사용자 정의 파서, Godot 프로세스가 필요 없으며 즉각적인 응답. - ️ - 노드를 선택, 신호를 연결, 저자의 시각 셰이너, 베이킹 라이트 맵, 설정 브레이크 포인트, 디버거를 단계, 실행하고 게임을 중지. - ↩️ - add, remove, rename, move, reparent, duplicate and instantiate all register on Godot's native undo stack. AI가 잘못되면 다시 넣어. - 😀 - 라이브 장면 트리를 검사, 호출 방법, 입력을 주입, 다른 공공 Godot MCP이. - ✪ - search tools는 386, get status에서 올바른 도구를 찾아서 연결되는 것을 정확히 알려줍니다. 모든 오류는 유형의 코드와 수리 힌트를 반환합니다.

개요(AI 번역)

Godot Engine을 위한 가장 완전한 MCP 서버 — **386 공구 ** 당신의 게임 프로젝트 안쪽에 당신의 AI 조수 진짜 손을 주는.

English | 한국어


Godot MCP는 AI 조수를 연결하는 모델 콘텍스 프로토콜 서버입니다. Claude, Cursor, VS Code Copilot, Windsurf, Cline, Codex, Aider - Godot Engine 4.x. AI는 프로젝트에 대해 추측하고 operating를 시작합니다.

  • **기본적으로 프로젝트 파일을 작성하고 작성 ** - .tscn] 장면, .tres 리소스, GDScript, C#, .gdshader, project.godot. 사용자 정의 파서, Godot 프로세스가 필요 없으며 즉각적인 응답.
  • ️ **라이브 라이브 편집기 ** - 노드를 선택, 신호를 연결, 저자 시각 셰이퍼, 베이 빛지도, 설정 브레이크 포인트, 디버거를 단계, 실행하고 게임을 중지.
  • ↩️ ** 모든 장면 편집은 무효 ** - 추가, 제거, 이름, 이동, reparent, duplicate and instantiate all register on Godot’s native undo stack. AI가 잘못되면 **Ctrl + Z ** 다시 넣어.
  • ₱ **런닝 게임 내의 회복 ** — 라이브 장면 트리를 검사, 통화 방법, 입력을 주입, ** 게임, 한 번에 하나의 프레임을 단계, 및 스크린 샷 결과. ** 다른 공공 Godot MCP가이 없습니다.

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.


Godot MCP is a Model Context Protocol server that connects any AI assistant — Claude, Cursor, VS Code Copilot, Windsurf, Cline, Codex, Aider — directly to Godot Engine 4.x. Your AI stops guessing about your project and starts operating it.

  • 📂 Reads and writes your project files natively — .tscn scenes, .tres resources, GDScript, C#, .gdshader, project.godot. Custom parsers, no Godot process required, instant response.
  • 🎛️ Drives the live editor — select nodes, connect signals, author visual shaders, bake lightmaps, set breakpoints, step the debugger, run and stop the game.
  • ↩️ Every scene edit is undoable — add, remove, rename, move, reparent, duplicate and instantiate all register on Godot’s native undo stack. If the AI gets it wrong, Ctrl+Z puts it back.
  • 🎮 Reaches inside the running game — inspect the live scene tree, call methods, inject input, freeze the game, step it one frame at a time, and screenshot the result. No other public Godot MCP does this.
  • 🔎 Stays usable at scale — search_tools finds the right tool out of 386, get_status tells you exactly what is connected, and every error returns a typed code plus a repair hint.

386 tools · 30 categories · 21 AI clients · 4 communication paths · one-command setup.

npx @yanhuifair/godot-mcp --enable-plugin -p .
Requirement
Godot 4.x (Godot 3 not supported)
Node.js >= 18
AI Client Any MCP-compatible client (see Configuration)

Why Godot MCP

Godot MCP Other Godot MCP servers
Tool count 386 across 30 categories 16 – 156
Works without Godot running ✅ Native .tscn / .tres / .godot parsers ⚠️ Usually needs a live editor
Live editor control ✅ 140 tools — play, debug, breakpoints, viewport, bake Partial
GitHub에서 전체 README 보기

설치

npx -y @yanhuifair/godot-mcp -p .
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "godot-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@yanhuifair/godot-mcp", "-p", "."] } } }