
satelliteoflove/godot-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
satelliteoflove/godot-mcp — это кандидат на MCP-сервер, импортированный из https://github.com/satelliteoflove/godot-mcp.
Обзор
satelliteoflove/godot-mcp — это кандидат на MCP-сервер, импортированный из https://github.com/satelliteoflove/godot-mcp.
Обзор (машинный перевод)
Дайте вашему ассистенту искусственного интеллекта глаза и руки в редакторе Godot — и получить беговую игру, которую он действительно сможет протестировать.
Почему именно этот?
Существует несколько серверов Godot MCP, и большинство из них могут открыть сцену и проникать в узлы. Этот проект построен вокруг более сложной задачи: позволить агенту проверить свою собственную работу. Запустите игру, управляйте ею как игрок, наблюдайте, что произошло на самом деле, и доказываете, что изменение сделало то, что заявлено — без пересылки скриншотов и журналов ошибок туда-сюда.
Какие вещи делают это возможным и которые вы не найдёте нигде больше:
- Детерминированное тестирование. Заморозить игровые часы, пошаговать точные срезы игрового времени (или шаг до выполнения условия), с входами внутри окна. Наблюдение никогда не гонит игру.
- Дешёвое наблюдение. Состояние живой сущности — позиции, скорости, состояние анимации, ваши собственные пользовательские данные — в виде структурированного JSON. Большинство вопросов типа «что происходит на экране?» получают ответы без траты токенов видения на скриншот.
- Реальный ввод. Именованные действия с аналоговой силой, кнопки джойпада и векторы стика, необработанные клавиши с модификаторами, относительный вид мыши, текст.
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
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"]
}
}
}