Godot MCP Server

godot-mcp を使用すると、MCPクライアントはGodotプロジェクトの検査、検証、テスト、エクスポート、およびクエリを実行できます。ヘッドレスGodotコマンドと、オプションで開いているGodotエディタからのライブ状態をサポートします。

要件

• Node.js 18以降

• Godot 4.1以降（ローカルにインストール済み）

• project.godot を含むGodotプロジェクト

ライブエディタツールには、後述のMCP Bridgeアドオンが追加で必要です。残りのツールはヘッドレスで実行されます。

Related MCP server: godot-ai-mcp

インストール

ローカルチェックアウトから

npm install
npm run build

npmから（公開後）

npx -y @zbrkic/godot-mcp --project /path/to/godot-project --godot /path/to/godot

MCPクライアントの設定

常にプロジェクトパスを指定してください。MCPデスクトップクライアントは通常、サーバーを独自の作業ディレクトリで起動するため、自動プロジェクト検出だけでは信頼できません。

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "@zbrkic/godot-mcp"],
      "env": {
        "GODOT_PROJECT_PATH": "C:/Source/my-game",
        "GODOT_PATH": "C:/Program Files/Godot/Godot_v4.5.1-stable_win64_console.exe"
      }
    }
  }
}

同等のコマンドラインオプションは次のとおりです：

godot-mcp --project /path/to/godot-project --godot /path/to/godot

GODOT_PATH/--godot は、godot 実行可能ファイルがすでに PATH 上にある場合にのみオプションです。Windowsでは、_console.exe 実行可能ファイルが優先されます。

ライブエディタツールの有効化

1. godot-plugin/addons/mcp_bridge を <your-project>/addons/mcp_bridge にコピーします。

2. Godotで、Project > Project Settings > Plugins を開き、MCP Bridge を有効にします。

3. ライブツールを使用している間は、Godotエディタを開いたままにしてください。

ブリッジはデフォルトで 127.0.0.1:7000 で待ち受けます。project.godot の mcp/plugin/port を設定して上書きします。サーバーは上記で設定したプロジェクトからその設定を読み取ります。本番エクスポートプリセットから addons/mcp_bridge/* を除外してください。

ツール

• プロジェクトとエクスポート：get_project_settings、list_export_presets、export_project

• テストと検証：run_tests、validate_scene、validate_script、run_scene、format_gdscript

• シーンとリソース：inspect_scene_tree、find_nodes、get_node_properties、get_node_connections、list_resources、get_resource_dependencies、resolve_path、get_resource_info

• ドキュメント：verify_api、get_help

• ライブエディタ：get_editor_selection、get_open_scenes

ほとんどのツールは、success、data、errors、warnings、およびタイミングメタデータを含む構造化JSON結果を返します。

開発と検証

npm test              # TypeScript build plus MCP handshake and parser tests
npm run test:godot    # GDScript syntax checks; requires GODOT_PATH or godot on PATH
npm pack --dry-run    # Inspect the files that would be published

GitHub Actionsは、プッシュとプルリクエストの両方でNode/MCPテストとGodotアドオンチェックを実行します。

リリースチェックリスト

1. package.json のバージョンを更新します。

2. npm test、npm run test:godot、npm pack --dry-run を実行します。

3. npm publish で公開し、対応するGitHubリリースを作成します。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。