firekula/mcp-bridge

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

236 stars 80 forks 品質 74 トレンド 22NOASSERTION

Cocos Creator 2.4.x MCP Bridge — ローカルHTTPサービスを起動し、Claudeや他のAIがModel Context Protocolを通じてエディターを直接制御できるようにします。30+ツールが完全に自動化されており、シーンノード管理、コンポーネントの追加、削除、変更、クエリ、オフラインプリフォームの変更、リソース管理、プロジェクト構築などが含まれます。— QQグループ:788307395

概要

これはCocos Creator向けに設計されたMCP(Model Context Protocol)ブリッジプラグインで、外部AIツールとCocos Creatorエディターを接続し、シーンやノード、その他のリソースに対する自動操作を可能にします。このプラグインはCocos Creatorバージョン2.4.xに対応しています。特定のエディタAPIを使用しているため、新バージョンや古いバージョンとは互換性がない場合があります。 - : 標準的なHTTPインターフェースを提供し、外部ツールはMCPプロトコルを通じてCocos Creatorエディター機能を呼び出せる - : シーン内のノードの取得、作成、変更 - : シーンやプリセットの作成、シーンやプリセットの開き、編集モードに入る - : ノードコンポーネントの追加、削除、取得 - : スクリプトファイルの作成、削除、読み取り、書き込み - : 複数のMCPツール操作をバッチ実行して効率化 - : リソース情報の作成、削除、移動、取得 - : 迅速かつ安全なオフラインエディターエンジン。プリファブリック(.prefab)とシーン(.fire)の物理的な骨格の違いを自動的に認識。ゼロからリソーススケルトンの作成、ディープコピー参照再計算クローン、レンダーレベルの再順序付け、ネスト配列参照バインディング(clickEvents[0].target)、属性参照バインディング、物理的削除+クラッシュ防止の深い再帰参照更新をサポートします。エディターのプライベートシリアライゼーションフィールド(_N$)は自動的に同期され、デシリアライズのデシリアライズのデスロックやウォッチャーブロッキングを完全に解消します。- : 詳細な操作ログ記録と表示を提供し、プロジェクトログファイルへの永続書き込みをサポートします - : エディター起動時の自動サービス開始をサポートします - : 選択したオブジェクトの取得と設定、エディターの更新 - : 条件に基づいてシーン内のノードを検索 - : マテリアルリソースを作成・管理 - : テクスチャリソースを作成・管理 - : Cocos Creatorエディターのメニュー項目を実行する - : ファイルにテキスト編集操作を適用 - : エディターのコンソール出力を読み取る - : スクリプト構文の正確性を検証 - : プロジェクト内のテキスト内容を検索 - : エディターの元に戻しスタックを管理する - : パーティクルシステムを作成・修正 - : コマンドキューは直列的に実行され、キューのエントリ数は100個(超過するとHTTP 429を返す)で、エディタフリーズを防ぎます。- : IPC通信とコマンドキューにはタイムアウト安全機構があります。- : コアコンポーネント属性ブラックリスト機構により、ノードやUUID参照を改ざんしてAIがクラッシュするのを防ぎます。- : パラメータエイリアスマッピング(操作→アクション、保存→更新/書き込み)、大規模モデル錯覚に対応しています。- : 指定されたノードやリソースを参照されるシーン内のすべての場所を見つけ、Texture2D→をサポートし...

概要（AI 翻訳）

これはCocos Creator向けに設計されたMCP(Model Context Protocol)ブリッジプラグインで、外部AIツールとCocos Creatorエディターを接続し、シーンやノード、その他のリソースに対する自動操作を可能にします。

該当するバージョン

このプラグインはCocos Creatorバージョン2.4.xに対応しています。特定のエディタAPIを使用しているため、新バージョンや古いバージョンとは互換性がない場合があります。

機能的特徴

HTTP Service Interface:標準的なHTTPインターフェースを提供し、外部ツールがMCPプロトコル経由でCocos Creatorエディタの機能を呼び出せるようにします
シーンノード操作:シーン内のノードの取得、作成、変更
リソース管理:シーンとプリフォームを作成し、シーンやプレフォームを開いて編集モードに入る
コンポーネント管理:ノードコンポーネントの追加、削除、取得
スクリプト管理:スクリプトファイルの作成、削除、読み取り、書き込み
バッチ実行:複数のMCPツール操作を効率化するためのバッチ実行
資産管理:リソース情報の作成、削除、移動、取得
オフラインプリセット/シーン修正:高速で安全なオフライン編集エンジン。プリセット(.prefab)とシーン(.fire)間の物理スケルトンの違いを自動的に検出します。リソーススケルトンのゼロ作成、ディープコピー参照再計算クローン、レンダーレベルの再並べ替え、ネスト付き配列参照バインディング(clickEvents[0].target)、属性参照バインディング、物理削除+深層再帰参照更新によるクラッシュ防止をサポートします。エディターのプライベートシリアライゼーションフィールド(_N$)は自動的に同期し、デシリアライズのデッドロックやウォッチャーブロッキングを完全に排除します。
リアルタイムログ:詳細な作業ログ記録と表示を提供し、プロジェクトログファイルへの永続書き込みをサポートします
自動スタート:エディター起動時にサービスを自動的に有効化する機能
エディター管理:選択したオブジェクトを取得・設定し、エディターを更新します
ゲームオブジェクト検索:条件に基づいてシーン内のノードを見つける
資材管理:資材資源の作成と管理
テクスチャ管理:テクスチャリソースの作成と管理
メニュー項目実行:Cocos Creatorエディターのメニュー項目を実行する
コード編集の強化:ファイルにテキスト編集操作を適用します
コンソール読み取り:エディタコンソールからの出力を読み取る
スクリプト検証:スクリプトの構文正確性を検証します
グローバル検索:プロジェクト内のテキストコンテンツを検索
元に戻す/やり直す:エディターの元に戻しスタックを管理する
特殊効果管理:パーティクルシステムの作成および修正
並行性セキュリティ:コマンドキューはシリアルモードで実行され、キューのエントリ数は100エントリ(超過制限はHTTP 429)に制限され、エディタのフリーズを防ぎます。
タイムアウト保護:IPC通信および命令キューにはタイムアウト安全機構が備わっています
属性保護:コンポーネントのコア属性ブラックリスト機構で、node]や[uuid]のような参照をAIが改ざんし、クラッシュを引き起こすのを防ぐための仕組みです

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

インストール

npx tsc --noEmit

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

{
    "mcpServers": {
        "mcp-bridge": {
            "command": "node",
            "args": ["[插件安装路径]/dist/mcp-proxy.js"]
        }
    }
}