defold-mcp

defold-mcp

Note: MCP（Model Context Protocol）サーバーを作成するのは今回が初めてです。完璧ではなく、実際、多くの機能が不足していますが、私より詳しい方がここまで作ったものを引き継ぎ、さらに発展させてくれることを願っています！

---

🚀 defold-mcp とは？

defold-mcp は、Defold ゲームエンジンと最新の開発者向けツールや AI を活用したワークフローをつなぐために設計された、オープンソースの Model Context Protocol（MCP）サーバーです。Defold プロジェクトをプログラムから自動化、調査、管理するための強力なツールを提供し、開発者が次のことを簡単に行えるようにします。

• Defold プロジェクトの起動とデバッグ
• Lua スクリプトやモジュールの生成と編集
• コレクション、スプライト、タイルマップなどの作成
• プロジェクトの設定や依存関係の管理
• ホットリロードとリアルタイム分析の有効化
• AI 支援によるゲーム開発のために、Cursor などのツールと連携

✨ 機能

• 包括的なツールセット： 幅広い Defold プロジェクトの操作を MCP ツールとして提供します（全一覧は以下を参照）。
• Apple Silicon と Dotenv のサポート： Apple Silicon 搭載 Mac でそのまま動作し、.env ファイルによる環境設定にも対応しています。
• プロジェクト管理の自動化： コマンドラインまたは対応クライアントから、Defold プロジェクトを簡単に作成、一覧表示、設定できます。
• スクリプトとアセットの自動化： スクリプト、コレクション、スプライトなどをプログラムから生成できます。
• デバッグと分析： プロジェクトをデバッグモードで実行し、コンソール出力を記録して、プロジェクトの変更に関する分析情報を取得できます。
• 拡張可能： ほかの方が改良、拡張し、新しいワークフローに合わせて適応できるように作られています。

🛠️ 提供されるツール

defold-mcp は、次の MCP ツールを提供します。

• launch_defold：プロジェクトの Defold エディターを起動
• run_project：Defold プロジェクトをデバッグモードで実行し、出力を記録
• create_project：基本構成を備えた新しい Defold プロジェクトを作成
• list_projects：ディレクトリ内のすべての Defold プロジェクトを一覧表示
• get_project_settings：game.project の設定を読み取り
• update_project_settings：game.project の設定を更新
• create_script：新しい Lua スクリプトを作成
• edit_script：既存の Lua スクリプトを編集
• create_lua_module：再利用可能な Lua モジュールを作成
• create_collection：新しいコレクションを作成
• add_game_object：コレクションにゲームオブジェクトを追加
• add_component：ゲームオブジェクトにコンポーネント（スプライト、スクリプトなど）を追加
• create_sprite：スプライトアセットを作成して追加
• create_tilemap：タイルマップアセットを作成して追加
• create_particlefx：パーティクルエフェクトを作成して追加
• create_camera：カメラコンポーネントを作成して追加
• create_factory：ゲームオブジェクトを生成するファクトリーコンポーネントを作成
• create_gui：GUI シーンとスクリプトを作成
• setup_physics：コリジョンオブジェクトの物理設定を構成
• build_project：対象プラットフォーム向けにプロジェクトをビルド
• enable_hot_reload：プロジェクトファイルを監視してホットリロードを有効化
• add_native_extension：ネイティブ拡張機能を追加
• get_project_analytics：プロジェクトの変更に関する分析情報を取得

...ほかにもあります！全一覧と詳細は index.js を参照してください。

⚡️ はじめに

1. リポジトリをクローン：

   git clone https://github.com/yourusername/defold-mcp.git
   cd defold-mcp
   

2. 依存関係をインストール：

   npm install
   

3. 環境を設定（任意）： デフォルト設定を上書きするには、.env ファイルを作成してください（DEFOLD_PATH や MCP_PORT などの変数については index.js を参照）。
4. サーバーを実行：

   node index.js
   

5. お好みの MCP 対応クライアント（Cursor など）に接続します。

---

🛠️ Cursor または Windsurf での使用

Cursor または Windsurf を使用している場合、サーバーを手動で実行する必要はありません。代わりに、プロジェクトの .cursor/mcp.json に設定ファイルを追加すると、クライアントがサーバーを自動的に起動して管理できるようになります。

設定例を以下に示します。

{
  "mcpServers": {
    "defold-mcp": {
      "command": "/path/to/your/node/binary", // e.g., ~/.nvm/versions/node/v22.14.0/bin/node
      "args": ["/path/to/where/you/cloned/defold-mcp/index.js"], // e.g., ~/git/defold-mcp/index.js
      "env": {
        "MCP_TRANSPORT": "stdio",
        "DEFOLD_PATH": "/Applications/Defold.app/Contents/MacOS/Defold",
        "MCP_PORT": "3000",
        "MCP_HOST": "localhost",
        "BOB_PATH": "/desired/path/for/bob.jar" // e.g., ~/defold/bob-1.9.6.jar
      }
    }
  }
}

• command：Node.js のバイナリへのパスです。ターミナルで which node を実行すると確認できます。
• args：このプロジェクトをクローンした場所にある index.js ファイルへのパスです。
• BOB_PATH：Defold の bob.jar ファイルをインストールする、または見つける場所のパスです。

これにより、プロジェクトを開くたびに Cursor または Windsurf が defold-mcp サーバーを自動的に起動、停止、接続できるようになります。環境に合わせてパスと環境変数を調整してください。

💡 このプロジェクトの理由

Defold を MCP サーバーの構築と Defold ゲームエンジンとの統合に初めて挑戦する場として、defold-mcp を作成しました。Defold を自動化や AI 主導のワークフローでより活用しやすくすることが目標でした。まだ改善の余地があることは承知していますが、このプロジェクトがほかの人の貢献や改善、さらなる発展につながることを願っています。

改善できる点があれば、フォークや貢献、またはお気軽にご連絡ください。Defold コミュニティのために、みんなで素晴らしいものを作りましょう。

🤝 貢献

貢献、バグ報告、機能リクエストを歓迎します。Issue を作成するか、プルリクエストを送信してください。

📄 ライセンス

このプロジェクトは MIT ライセンスです。

---

好奇心とゲーム開発への愛を込めて作成しました。