
satelliteoflove/godot-mcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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
설치
npx -y @satelliteoflove/godot-mcp설정
{
"mcpServers": {
"godot-mcp": {
"command": "npx",
"args": ["-y", "@satelliteoflove/godot-mcp"]
}
}
}