Cocos MCP Community

English | 简体中文

コミュニティ製の Model Context Protocol (MCP) 拡張機能です。Cocos Creator 3.8+ 向けに作られており、互換性のある AI クライアントを接続し、Cocos Creator で現在開いているプロジェクトを確認・操作できます。

拡張機能はローカルで実行され、127.0.0.1 で待ち受け、永続的まあ構的変更に明示的確認が必要です。

現在のバージョン: 0.2.3。自動テストスイートは合格し、主要な読取リワークフローと分離された書込ーワクフローは Cocoss Creator 3.8.8 で検証済みです。

Features

サーバーは23個の意図向けのMCPツールを公表します。各ツールは関連する操作をまとめているため、クライアントはエターの広範エを受けたまま、焦点を絞られたツール一覧を受け取れます。

追加のワークフロー機能として、セッション対応 Streamable HTTP、ツール一覧の変変更通知、スキーマ検証済み入、確認ゲート、ロールバック対応のバッチ操作、プロジェクトーカルなツールプリセットがああります。

Related MCP server: Cocos Creator MCP Server

要件

• Cocos Creator 3.8 以上

• Node.js 18 以上

• npm

• Streamable HTTP に対応した MCP クライアント

インストールと使い方

1. 拡張機能のインストール

リポジトリをCocos プロジェクトのextensions ディレクトリにクローンし、依存関係をインストールしてビルドします:

cd /path/to/YourCocosProject/extensions
git clone <repository-url> cocos-mcp-community
cd cocos-mcp-community
npm ci
npm run build

Cocos Creator でプロジェクトを開きます。エディタがすでに開いている場合は、拡張機能をリロードするかエディタを再起動します。

2. MCP サーバーの起動

Extension → Cocoos MCP Community を開き、Start server を選択します。デフォルトのエンドポイントは次のとおりです:

http://127.0.0.1:3100/mcp

パネルにはアクティブなエンドポイントとサーバーの状態が表示されます。プロジェクト・ローカルのポートを変をてたり、自動起動を有効にしたりもできます。

3. MCP クライアントを接続

クライアントのMCP 設に Streamable HTTP サーバーを追加します。汎用的なサーバーエントリは次のとです:

{
  "type": "http",
  "url": "http://127.0.0.1:3100/mcp"
}

周り設定はクライアントによって異なります。初回の接続後、client_config ツールれ Claude Desktop、Cursor、VS Code、Windsurf の完全なエントリを生成できます。

設定を変更後たは、 MCPクライアントを再起動または再接続してください。Cocos パネルでサーバーポートを変た場合は、クライアント の URL も更新してください。

4. 接続の確認

対対象のプロジェクトとシーンを Cocos Creatorに開いたまま、AI クライアントに次のような読取専操作を依頼します:

Summarize the current Cocos scene hierarchy.

List the assets under db://assets and report any missing references.

Check the current editor and Preview errors without changing the project.

クライアントがプロジェクト情報かシーン情報を返せば、接続は完了です。

5. 編集ワークフロー

エディタのタスクを自然言語で説明できます。例:

Create a Canvas with a centered panel, a title, and a button in the current scene.

Set the selected Label font size to 32 and change its text to "Play".

Create an AnimationClip that moves the selected node from x=0 to x=300 in one second.

持続的な変更には確認が必要です。推奨ワークフロー:

1. クライアントに現在の状態を検カ式し、予定の変を説明させます。

2. 対対象のシーン、ノード、アセット、パスを確認します。

3. 権限要求が来たら、操作を確認します。

4. Cocos Creatorで結果を確認し、適切にシーンを保存します。

重要事項を変更する前に、コミットまたはバックアップしておいてください。初めての試用では、使い捨てのシーンと一時アセットを使用してください。

ツール管理

拡張機能パネルには2つのタブがあります:

• Server: ポート・自動起動・サーバ状態を制御します。

• Tool 管理: 個別ツールの話と切りのほかへ、All、Core workflow、UI マーク、それに Minimal のプリセットを提供します。

公開するツールの数を節ると、クライアントに送信される MCP ツール定義も減ります。preferences によって復旧ツールは常に利用できます。ツール一覧の変更通知をサポートしているクライアントは自動的に更新されますが、ツール一覧が変わらない場合は再バイ接続します。

設定はプロジェクトごとに library/cocos-mcp-communit.settings.json に保存されます。

トラブルシューティング

• クライアントが接続できない: Cococ Creatorが起動しいること、拡張機能が有効であること、パネルがサーバーが実行中であることを確認し、クライアントのURLが同じポートを指していることを確します。

• ツール一覧が古い: Tool 管理の変更お後に** の反後に MCP クライアントを接続します。

• シーン操作が失敗する: 対象シーンを開いて、まず読取専用のシーン要約を試してください。

• 編集が拒否される: 対象のUUIDまたはアセットパスを確認し、要求されている書き込み操作を明示的に承認してください。

• ポート使用中: 1024〜65535 の範囲で別のポートを Server タブから選択し、クライアント設定を更新してください。

開発

npm install
npm run check
npm run build
npm run test:ci

スモークスイートはCocos プロジェクトを変更しません。統合テストで書き込む場合は、使い捨てシーンと一時アセ・ットを使用してください。

プロジェクト構造

src/main.ts                 Extension lifecycle and panel messages
src/server/                 MCP transport, sessions, and tool registration
src/cocos/editor-bridge.ts  Cocos Editor integration
src/scene.ts                Scene-process operations
src/tools/                  Schema-validated MCP tools
src/panels/default/         Dockable extension panel
scripts/                    Regression and smoke tests

コントリビューション

Issueやのプルリクエストを歓迎します。CONTRIBUTING.md を読ん、確認レーションゲート維持、ユーザー向き変更にはテストスドキメドを添付してください。

謝辞

以下のオープンソースプロジェクトに参照とインスピレーションを感謝します :

• ocos-mcp-server

• axianLee/cocos-mcp-server

ライセンス

MIT ライセンス の下に公開されています。

これは独立したコミュニティプロジェクトであり、Cocos 公式のプロダクトではありません。Cocos と Cocos Creator はそれぞれの所有者の商標です。