SG

satelliteoflove/godot-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

182 stars 22 forks Качество 84 Тренд 31MIT

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

Открыть полный README на GitHub

Установка

npx -y @satelliteoflove/godot-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

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