better-godot-mcp

2026-09-13 にアーカイブ済み — このリポジトリはメンテナンスされなくなりました。この MCP サーバーではなく、Godot エディターと GDScript CLI ツールチェーンを使用してください。既存のインストールは引き続き動作しますが、更新やサポートは提供されません。

Better Godot MCP

mcp-name: io.github.n24q02m/better-godot-mcp

Godot Engine 用の複合 MCP サーバー — AI を活用したゲーム開発向けの 17 個の複合ツール。

n24q02m の姉妹プロジェクト（クリックして展開）

| プロジェクト | タグライン | タグ | |---|---|---| | [agent-chat-plugin](https://github.com/n24q02m/agent-chat-plugin) | AI エージェント同士が共有フォルダーでチャット — 人間による中継もオーケストレーターも不要、wor... | ツーリング | | [better-code-review-graph](https://github.com/n24q02m/better-code-review-graph) | トークン効率に優れたコードレビューのためのナレッジグラフ — セマンティック検索と呼び出し-... | MCP | | [better-drive](https://github.com/n24q02m/better-drive) | .driveignore フィルターを使った Google Drive の双方向同期 — rclone エンジン、Windows トレイ | ツーリング | | [better-email-mcp](https://github.com/n24q02m/better-email-mcp) | AI エージェント向け IMAP/SMTP メール — メールの閲覧、送信、フォルダーの整理、属性の管理... | MCP | | [better-godot-mcp](https://github.com/n24q02m/better-godot-mcp) | Godot Engine 用の複合 MCP サーバー — AI 支援によるゲーム制作のための17個の複合ツール... | MCP | | [better-notion-mcp](https://github.com/n24q02m/better-notion-mcp) | AI エージェント向けの Markdown ファーストな Notion — ページ、データベース、ブロック、コメント... | MCP | | [better-semantic-release](https://github.com/n24q02m/better-semantic-release) | リリースの安全性を守るガード機能を内蔵した、すぐに置き換えて使える python-semantic-release フォーク（orp... | ツーリング | | [better-telegram-mcp](https://github.com/n24q02m/better-telegram-mcp) | AI エージェント向け Telegram — 両方のボ...でのメッセージ、チャット、メディア、連絡先 | MCP | | [better-workspace-mcp](https://github.com/n24q02m/better-workspace-mcp) | Google Workspace MCP サーバー（Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch...） | MCP | | [claude-plugins](https://github.com/n24q02m/claude-plugins) | n24q02m の MCP サーバー向け Claude Code プラグインマーケットプレイス — ウェブ検索をインストール... | マーケットプレイス | | [imagine-mcp](https://github.com/n24q02m/imagine-mcp) | AI エージェント向けの画像・動画理解と生成 — Gemini、Op...などに対応 | MCP | | [jules-task-archiver](https://github.com/n24q02m/jules-task-archiver) | batchexecute API 経由で Jules タスクを一括操作する Chrome 拡張機能 — a... | ツーリング | | [mcp-core](https://github.com/n24q02m/mcp-core) | MCP サーバー構築のための共有基盤 — Streamable HTTP トランスポート、OAuth... | MCP | | [mnemo-mcp](https://github.com/n24q02m/mnemo-mcp) | ハイブリッド検索と埋め込み同期を備えた永続的な AI メモリー。オープン、無料、無制限... | MCP | | [qwen3-embed](https://github.com/n24q02m/qwen3-embed) | ONNX Runtime と GGUF による軽量な Qwen3 テキスト埋め込みとリランキング | ライブラリ | | [skret](https://github.com/n24q02m/skret) | サーバー不要のシークレット管理。 | CLI | | [tacet](https://github.com/n24q02m/tacet) | ナレッジ...全体で LLM コストを償却する、自己蒸留型ニューロシンボリックカスケード | ツーリング | | [web-core](https://github.com/n24q02m/web-core) | 検索、スクレイピング、HTTP セキュリティ、st...向けの共有ウェブインフラストラクチャーパッケージ | ライブラリ | | [wet-mcp](https://github.com/n24q02m/wet-mcp) | AI エージェント向けのオープンソース MCP サーバー：ウェブ検索、コンテンツ抽出、ライブラリ... | MCP |

目次

• 機能
• インストール
• Smithery
• ドキュメント
• ツール
• 比較
• 設定
• CLI
• セキュリティ
• ソースからビルド
• 信頼モデル
• ライセンス

機能

• 17個の複合メガツール — シーン、ノード、スクリプト、シェーダー、アニメーション、タイルマップ、物理演算、オーディオ、ナビゲーション、UI など
• シーンを完全に制御 — Godot を起動せずに .tscn ファイルを直接作成、解析、変更
• GDScript の CRUD — 1回の呼び出しでスクリプトを作成、読み取り、書き込み、アタッチ
• 段階的なトークン最適化 — 圧縮された説明と、必要に応じて使える help ツール

インストール

デフォルトでは stdio で動作します。認証情報、アカウント、リレーは不要です。サーバーはローカルの Godot プロジェクトファイルを直接読み書きします。ファイル操作に Godot 4.x は任意です。Godot バイナリが必要なのは run／stop／export と editor アクションのみです。検出機能は Godot >=4.1 に対応しています。現在、Godot 4.7.1 安定版での実際のエンジン互換性を確認済みですが、今後のすべてのマイナーリリースで確認済みであることを示すものではありません。

npx 経由（推奨）

npx -y @n24q02m/better-godot-mcp@latest

MCP クライアントの設定

クライアントの MCP 設定（Claude Code、Cursor、Windsurf、Codex、mcp.json）に追加します。

{
  "mcpServers": {
    "better-godot-mcp": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-godot-mcp"],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}

GODOT_PROJECT_PATH は任意です。各ツールでは、呼び出しごとに project_path 引数も指定できます。

Docker 経由

docker run -i --rm -v /path/to/your/godot/project:/project n24q02m/better-godot-mcp

イメージは amd64 と arm64 向けに公開されています。サーバーがシーン、スクリプト、リソースのファイルを読み書きできるよう、プロジェクトディレクトリをマウントしてください。

Smithery

better-godot-mcp には smithery.yaml が含まれているため、Smithery を通じて検出、デプロイできます。Smithery は npx -y @n24q02m/better-godot-mcp を介して stdio でサーバーを起動します。サーバーに認証情報はなく、ローカルの Godot プロジェクトファイルを直接読み込むため、起動時の設定は不要です。

ドキュメント

詳しいセットアップガイドは mcp.n24q02m.com/servers/better-godot-mcp/setup/ にあります。Claude Code、Codex、Gemini CLI、Cursor、Windsurf、mcp.json のインストール手順を説明しています。

AI エージェントでインストール — 次の内容を AI コーディングエージェントに貼り付けてください。

手順に従って MCP サーバー better-godot-mcp をインストールしてください。 https://raw.githubusercontent.com/n24q02m/claude-plugins/main/plugins/better-godot-mcp/setup-with-agent.md

ツール

ツール	アクション	説明
project	info、version、run、stop、settings_get、settings_set、export	プロジェクトのメタデータ、実行／停止、設定
scenes	create、list、info、delete、duplicate、set_main	シーンファイルの管理
nodes	add、remove、rename、list、set_property、get_property	シーンツリーのノード操作
scripts	create、read、write、attach、list、delete	GDScript ファイルの CRUD
editor	launch、status	Godot エディターの起動とステータス確認
config	status、set、detect_godot、check	サーバー設定と環境検出
resources	list、info、delete、import_config	リソースファイルの管理
input_map	list、add_action、remove_action、add_event	入力アクションとイベントのマッピング
signals	list、connect、disconnect	シグナル接続
animation	create_player、add_animation、add_track、add_keyframe、list	アニメーションプレーヤーとトラック
tilemap	create_tileset、add_source、set_tile、paint、list	TileMap と TileSet の管理
shader	create、read、write、get_params、list	Godot 4 の構文に対応したシェーダーファイルの CRUD
physics	layers、collision_setup、body_config、set_layer_name	衝突レイヤーと物理ボディ
audio	list_buses、add_bus、add_effect、create_stream	オーディオバスとエフェクトの管理
navigation	create_region、add_agent、add_obstacle	ナビゲーション領域、エージェント、障害物
ui	create_control、set_theme、layout、list_controls	UI コントロールの作成とテーマ設定
help	-	任意のツールの完全なドキュメントを取得

比較

各機能領域における、better-godot-mcp と直接競合するツールの比較です。

機能	better-godot-mcp	Coding-Solo/godot-mcp	bradypp/godot-mcp	tugcantopaloglu/godot-mcp
シーンファイル管理	対応（scenes：作成／一覧表示／情報取得／削除／複製／メインに設定）	対応（作成／保存）	対応（作成／保存）	対応（作成／読み取り／変更）
ノードツリー操作	対応（nodes：追加／削除／名前変更／一覧表示／プロパティの取得・設定）	一部対応（追加のみ）	対応（追加／編集／削除）	対応（追加／削除／親ノードの変更）
GDScript ファイルの CRUD	対応（scripts：作成／読み取り／書き込み／アタッチ／一覧表示／削除）	非対応	非対応	一部対応（テンプレートから作成＋実行時評価）
シェーダーファイルの CRUD	対応（shader：作成／読み取り／書き込み／パラメーター取得／一覧表示）	非対応	非対応	一部対応（.gdshader の作成／読み取り）
アニメーションの作成	対応（animation：プレイヤー／トラック／キーフレーム）	非対応	非対応	対応（プレイヤー／トゥイーン／ステートマシン）
TileMap／TileSet	対応（tilemap：タイルセット／ソース／タイル設定／ペイント）	非対応	非対応	対応（TileMapLayer のセル）
物理レイヤー／ボディ	対応（physics：レイヤー／衝突／ボディ設定）	非対応	非対応	対応（衝突／ジョイント／レイキャスト）
オーディオバス管理	対応（audio：バス／エフェクト／ストリーム）	非対応	非対応	対応（バス／ルーティング／エフェクト）
ナビゲーション設定	対応（navigation：リージョン／エージェント／障害物）	非対応	非対応	対応（ナビゲーション）
UI コントロールの作成	対応（ui：コントロール／テーマ／レイアウト）	非対応	一部対応（ノードの追加経由）	対応（コントロール／テーマ／メニュー）
入力マップの編集	対応（input_map：アクション／イベント）	非対応	非対応	対応（アクション／キー割り当て）
シグナル接続	対応（signals：接続／切断／一覧表示）	非対応	非対応	対応（接続／発行／待機）
エディターの起動／プロジェクトの実行	対応（editor、project の実行／停止）	対応	対応	対応
エディターを起動せずに動作	対応（テキストベースの .tscn 解析）	対応（ヘッドレス GDScript ブリッジ）	対応（ヘッドレス GDScript ブリッジ）	一部対応（CLI ヘッドレスまたはライブ TCP ソケット）
認証情報を保存しない（TC-Local）	対応	対応	対応	対応
stdio + HTTP トランスポート	対応（デフォルトは stdio、--http で切り替え）	非対応（stdio のみ）	非対応（stdio のみ）	非対応（stdio のみ）
Docker イメージ（amd64 + arm64）	対応	非対応	非対応	非対応
トークン階層化されたツールの説明	対応（簡潔な説明＋オンデマンドの help）	非対応	非対応	非対応

設定

Godot バイナリは一般的なインストール先と PATH から自動検出されます。基本的な使い方では、環境変数は必要ありません。必要に応じて GODOT_PROJECT_PATH と GODOT_PATH を設定すると、デフォルトを上書きできます。

変数	必須	デフォルト	説明
GODOT_PROJECT_PATH	いいえ	-	デフォルトのプロジェクトパス（ツールでは project_path パラメーターも指定できます）
GODOT_PATH	いいえ	自動検出	Godot バイナリへのパス

HTTP トランスポート

デフォルトでは、サーバーは stdio 経由で動作します。代わりに Streamable HTTP 経由で提供するには、--http を渡すか、MCP_TRANSPORT=http を設定します（TRANSPORT_MODE=http も使用できます）。HTTP モードでは認証なしの /mcp エンドポイントが公開されます。保護すべき認証情報はないため、信頼できるローカル環境またはセルフホスト環境での使用を想定しています。

変数	必須	デフォルト	説明
MCP_TRANSPORT	いいえ	stdio	Streamable HTTP トランスポートを使うには http を設定します
PORT	いいえ	0（自動割り当て）	HTTP ポート（HTTP モードのみ）
HOST	いいえ	サーバーのデフォルト	HTTP ホスト（HTTP モードのみ）

制限事項

• Godot 4.x のプロジェクト構造が必要です。ファイル操作では Godot バイナリは任意です。
• シーンファイル（.tscn）は、Godot の内部 API ではなく、テキスト操作によって解析・変更されます。
• run／stop／export アクションには、Godot バイナリのインストールが必要です。
• Docker モードではファイルシステムへのアクセスが制限されます（プロジェクトディレクトリをマウントしてください）。

CLI

better-godot-mcp バイナリは、デフォルトで MCP サーバーを起動します（stdio。Streamable HTTP を使用するには --http を追加します）。また、MCP クライアントに接続する前に Godot 環境を確認するための診断用サブコマンドも 2 つ用意されています。

コマンド	説明
better-godot-mcp	MCP サーバーを起動します（デフォルトは stdio。Streamable HTTP を使用するには --http を指定します）
better-godot-mcp detect	検出された Godot バイナリを JSON 形式で出力します（パス、バージョン、検出元）。見つからない場合はゼロ以外の終了コードで終了します
better-godot-mcp doctor	Godot バイナリと現在のプロジェクト（GODOT_PROJECT_PATH が設定されていればそのパス、そうでなければ作業ディレクトリ）をヘルスチェックします

# Detect the Godot binary (JSON output)
npx -y @n24q02m/better-godot-mcp detect

{
  "found": true,
  "path": "/path/to/godot",
  "version": {
    "major": 4,
    "minor": 7,
    "patch": 1,
    "label": "stable.official",
    "raw": "4.7.1.stable.official"
  },
  "source": "system"
}

# Health-check the Godot binary and project
npx -y @n24q02m/better-godot-mcp doctor

[ok] godot binary: /path/to/godot (source: system)
[ok] godot version: 4.7.1.stable.official
[warn] project: no project.godot found at /path/to/cwd (set GODOT_PROJECT_PATH)

Godot バイナリが見つからない場合、detect は終了コード 1 で終了します。バイナリが見つからない場合、doctor は終了コード 1 で終了します（project.godot が見つからない場合は警告のみです）。

セキュリティ

• バイナリの検出 -- 環境変数、PATH、一般的な場所など、複数の方法で Godot を検出します
• プロジェクトの検証 -- 操作の前に project.godot が存在することを確認します
• クロスプラットフォーム対応 -- Windows、macOS、Linux のパスを処理します

ソースからビルド

git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev          # stdio mode (default)
bun run dev:http     # Streamable HTTP mode

信頼モデル

このプラグインは TC-Local を実装しています（認証は不要で、認証情報は保存されません）。分類の詳細については、信頼モデルのリファレンスをご覧ください。

モード	ストレージ	暗号化	データを読み取れるユーザー
stdio（デフォルト）	N/A（認証情報なし）	N/A	N/A
HTTP セルフホスト	N/A（認証情報なし）	N/A	N/A

ライセンス

Apache-2.0 -- LICENSE をご覧ください。