Better Godot MCP

Name: Better Godot MCP
Author: n24q02m

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

Godot Engine用複合MCPサーバー -- AI支援によるゲーム開発のための17のメガツール

codecov npm Docker License: MIT

TypeScript Node.js Godot Engine semantic-release Renovate

特徴

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

Related MCP server: WET - Web Extended Toolkit

セットアップ

AIエージェントを使用する場合 -- 以下をコピーしてAIエージェントに送信してください：

Please set up @n24q02m/better-godot-mcp for me. Follow this guide: https://raw.githubusercontent.com/n24q02m/better-godot-mcp/main/docs/setup-with-agent.md

手動セットアップ -- docs/setup-manual.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`	-	任意のツールの完全なドキュメントを取得

設定

Godotバイナリは一般的なインストール場所と PATH から自動検出されます。基本的な使用には環境変数は不要です。必要に応じて GODOT_PROJECT_PATH と GODOT_PATH を設定してデフォルトを上書きできます。

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

制限事項

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

セキュリティ

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

ソースからのビルド

git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev

ライセンス

MIT -- LICENSE を参照してください。

Better Godot MCP

Better Godot MCP

特徴

セットアップ

ツール

設定

制限事項

セキュリティ

ソースからのビルド

ライセンス

Resources

Tools

Latest Blog Posts

MCP directory API