SG

satelliteoflove/godot-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

184 stars 22 forks 品質 81 トレンド 25MIT

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

GitHub で README 全文を見る

インストール

npx -y @satelliteoflove/godot-mcp
MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

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