
satelliteoflove/godot-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
satelliteoflove/godot-mcpは、https://github.com/satelliteoflove/godot-mcp.からインポートされたMCPサーバー候補です。
概要
satelliteoflove/godot-mcpは、https://github.com/satelliteoflove/godot-mcp.からインポートされた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"]
}
}
}