SG

satelliteoflove/godot-mcp

Developer tools

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

183 stars 22 forks 품질 81 트렌드 25MIT

satelliteoflove/godot-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

satelliteoflove/godot-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

Godot 편집기에서 AI 비서에게 눈과 손을 제공하고, 실제로 플레이테스트할 수 있는 러닝 게임을 만들어 보세요.

왜 이걸까?

몇몇 Godot MCP 서버가 존재하며, 대부분은 씬을 열고 노드를 탐색할 수 있습니다. 이 문제는 더 어려운 문제를 중심으로 만들어졌습니다: **에이전트가 자신의 작업을 검증하도록 하는 것. ** 게임을 실행하고, 플레이어처럼 운전하며, 실제로 무슨 일이 일어났는지 관찰하고, 변경이 주장하는 대로 작동했는지 증명하세요 — 스크린샷과 오류 로그를 계속 주고받는 대신 말입니다.

그걸 가능하게 하는 요소들, 그리고 다른 곳에서는 찾기 힘든 것들:

  • 결정론적 플레이테스트. 게임 클락을 정지하고, 게임 시간의 정확한 조각(또는 조건이 성립될 때까지*)을 한 단계 이동시키며, 입력은 창 안에서 진행됩니다. 관찰은 절대 게임을 경주하지 않습니다.
  • 저렴한 관찰 기능. 실시간 엔티티 상태 — 위치, 속도, 애니메이션 상태, 사용자 맞춤형 데이터 — 구조화된 JSON 형태로. 대부분의 ‘화면에 무슨 일이 일어나고 있나요?’ 질문은 스크린샷에 비전 토큰을 쓰지 않고도 답변할 수 있습니다.
  • 실제 입력. 아날로그 강도가 있는 이름 있는 동작, 조이패드 버튼과 스틱 벡터, 수정자 조합이 있는 원본 키, 상대 마우스 룩, 텍스트 타이핑.

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

README

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

godot-mcp

Give your AI assistant eyes and hands in the Godot editor — and a running game it can actually playtest.

Why this one?

There are a few Godot MCP servers out there, and most can open a scene and poke at nodes. This one is built around a harder problem: letting an agent verify its own work. Run the game, drive it like a player, observe what actually happened, and prove the change did what it claimed — without you ferrying screenshots and error logs back and forth.

The pieces that make that possible, and that you won’t find elsewhere:

  • Deterministic playtesting. Freeze the game clock, step exact slices of game time (or step until a condition holds), with inputs riding inside the window. Observation never races the game.
  • Cheap observation. Live entity state — positions, velocities, animation state, your own custom data — as structured JSON. Most “what’s happening on screen?” questions get answered without spending vision tokens on a screenshot.
  • Real input. Named actions with analog strength, joypad buttons and stick vectors, raw keys with modifier combos, relative mouse-look, text typing. Sequences run with precise timing and can prove they changed game state.
  • Scenario setup. Run GDScript inside the running game: grant the weapon, skip to wave 3, spawn a test bot — no debug hooks baked into your game code.

Here’s what that looks like when an agent tests a boss fight:

godot_editor_edit   run frozen=true           # boot with game time frozen at frame 0
godot_exec          GameState.wave = 3        # set up the scenario worth testing
godot_game_time     step_until "tree.get_nodes_in_group('boss').size() >= 1"
godot_runtime_state digest                    # exact positions and state — no pixels, no guessing
godot_game_time     step 500ms + dodge input  # play the moment that matters
godot_editor_read   screenshot_game           # and a screenshot when it's actually worth the tokens

Less copy-paste, more creating.

Quick Start

1. Configure your AI assistant

GitHub에서 전체 README 보기

설치

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

설정

{ "mcpServers": { "godot-mcp": { "command": "npx", "args": ["-y", "@satelliteoflove/godot-mcp"] } } }