Godot MCP

Godot MCP

Godot MCPは、GodotエンジンとClaudeなどのAIアシスタントをModel Context Protocolで接続する強力な統合プラグインです。これにより、開発環境内でAIによるプロジェクト支援、コード修正、シーン操作が可能になります。

Author: ee0pdt


プロトコルを表示

Godot MCPとは？

Godot MCPは、GodotプロジェクトとAIアシスタントを標準化されたModel Context Protocolを使用して接続するGodotエンジンプラグインです。これにより、AIツールがスクリプト、シーン、ノード、プロジェクト設定に直接アクセスし、分析し、修正できるようになります。開発、デバッグ、クリエイティブなコラボレーションのための新しいAI駆動のワークフローが実現します。

Godot MCPの設定方法

  • godot-mcpリポジトリをクローンし、そのディレクトリに移動します。
  • /serverディレクトリでnpm installとnpm run buildを実行してMCPサーバーを構築し、設定します。
  • Claude Desktopの設定ファイル（例：claude_desktop_config.json）を編集して、構築したサーバーのエントリファイルを指すMCPサーバーエントリを追加します。
  • PATH_TO_YOUR_PROJECTをクローンしたリポジトリの絶対パスに置き換えます。
  • 変更を適用するためにClaude Desktopを再起動します。
  • Godotで、提供されたサンプルプロジェクトを開くか、addons/godot_mcpフォルダを自分のプロジェクトのaddonsディレクトリに追加します。
  • Godotエディタのプロジェクト設定でプラグインを有効にします。

Godot MCPの使用方法

MCPサーバーが動作し、プラグインが有効な状態で、AIアシスタントインターフェース（例：Claude Desktop）から構造化または自然言語のプロンプトを使用してGodotプロジェクトと対話します。コマンドを@mcp godot-mcpで始めると、MCPサーバー経由でリクエストが送信されます。コード提案、シーン変更、AI生成コンテンツのリクエスト、プロジェクトやリソースコマンドの実行が可能です。

例

  • @mcp godot-mcp read godot://script/current
    「プレイヤーの移動コードを最適化する手助けが必要です。改善案を提案できますか？」
  • @mcp godot-mcp run get-scene-tree
    「シーンの中央にキューブを追加し、そのキューブを見ているカメラを作成してください。」
  • @mcp godot-mcp read godot://scene/current
    「ウェイポイント間をパトロールし、近づいたらプレイヤーを攻撃する敵AIを作成してください。」

主な機能

  • GodotとAIアシスタント間のシームレスな双方向通信
  • プロジェクトリソース、スクリプト、シーン、ノードをプログラム的にアクセス・修正
  • ノード管理、スクリプト編集、シーンおよびプロジェクト制御のための広範なコマンドセット
  • 追加のMCPツールエンドポイントで簡単に拡張可能
  • Claude Desktop経由での統合をサポートする安全なローカルまたはリモート設定
  • コーディング、デバッグ、シーン作成のための自然言語のAI駆動支援

使用例

  • GDScriptファイルのAI駆動のコードレビュー、生成、リファクタリング
  • 自動シーン作成、ノード管理、プロシージャルな環境生成
  • パフォーマンスの最適化やエラー検出のためのプロジェクト全体の分析
  • AIの提案を通じてのゲームプレイロジック、AI行動、UI要素の実装
  • AIのガイダンスによるリソースと設定の一括編集や作成
  • Godotプロジェクトでのプロトタイピング、学習、コラボレーティブ開発の加速

よくある質問

Q: プラグインが動作しないか、Godotに表示されません。どうすればよいですか？
A: プロジェクト > プロジェクト設定 > プラグインで「Godot MCP」プラグインを有効にしてください。最近アドオンをコピーしたり、設定を変更した場合は、プロジェクトを再読み込みし、Godotコンソールでエラーメッセージを確認してください。

Q: Claude DesktopがMCPサーバーに接続できません。どうしたらいいですか？
A: サーバーが正常に起動しているか確認してください（起動時にエラーがない）。Claude Desktopの設定が正しい絶対パスを持っていることを確認してください。MCP_TRANSPORTがstdioに設定されていることも確認してください。設定を更新した後、Claude Desktopを再起動します。

Q: 既存のプロジェクトでGodot MCPを使用できますか、それとも含まれているサンプルのみですか？
A: はい、任意のGodotプロジェクトで使用できます。addons/godot_mcpフォルダをプロジェクトのaddonsディレクトリにコピーし、設定からプラグインを有効にしてください。

Q: Godot MCPを拡張したり、カスタムコマンドを追加したい場合はどうすればいいですか？
A: プラグインとサーバーはオープンソースで、拡張性を考慮して設計されています。MCPサーバーに新しいエンドポイントを実装したり、Godotアドオンを拡張して追加機能を公開することができます。

Q: Godot MCPを使用すると、プロジェクトのデータは安全ですか？
A: はい、MCPサーバーはデフォルトでローカルマシン上で動作し、あなたが許可したファイルとデータにのみアクセスします。サーバー設定を見直し、データセキュリティのベストプラクティスを常に念頭に置いてください。