Skip to main content
Glama
cocos-mcp-community

cocos-mcp-community

by chang0022

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ツールを公表します。各ツールは関連する操作をまとめているため、クライアントはエターの広範エを受けたまま、焦点を絞られたツール一覧を受け取れます。

ツール

機能

project

Project configの読取と 자サリの概要、プロジェクト設定の照会・更新

scene

アクティブなシーンと階層の検査、シーンの開く・保箱・名前を付けて保存

node

ノードの探索・検査・作成・更新・複製・コピー・カット・ペースト・リセット・再親化・削除

component

コンポネントの一覧・追加・削除・検査・編集・リセット、配列とButtonイベントの編集、テキストスタイルの適用

asset

AssetDBのチェック、アセットの一覧・検査、安全なテキストアセットの読込、インポート、作成、保存、コピー、移動、リフレッシュ、リイインポート、削除

prefab

プレハブの一覧・検査、使用所の検索、リンク付き複製または非リンク付き複製のインスタチスタイエーション、アセットのコピー・削除、インスタンスの復元

snapshot

階層スナップショットの取得・復元、スコープ付き構造トランザクションの開始・コミット・中止

builder

検証済みノードツリーまたは Canvas/Panel/Title/Button のUI画面を原子的に一括作成

validation

階層とUIの整合性チェック、リファレンスの検証、依存関係・循環参照・欠落項目・孤立ノード候補の分析

capture

構造化されたレイアウトデータ、CameraーレレンダリングPNG、またはトリンミングされた Preview キヤンバスのPNG を取込

animation

AnimationClipの作成・保存・一括生成・検査・増分編集、クリップのアタッチと制御

viewport

デザイン解能度とエディタビュの取得、ノードのフォーカス・揃え、2D、グリッド、ギジモ、アイコンの設定

editor

エディタコンテキスト、選択、未保存状態、レディネス、Creatorコンソール項目、プロジェクトログ、Previewエラーを読取

preview

Previewネットワーの確認、サポート先の起動、Preview、グームビューの停止、ロールカルPreviewボタンの実行

ui

Canvas確保と、テンプレート、Layoutコンテナ、ダイアログ、リスト、ナビゲーション・バー、または設定画面の作成

spine

Spineデータの設定、sp.Skeleton 上のアニメーションの一覧・再生・待機・クリア

font

プロジェクトフォントの一覧と、cc.Label へのプロジェクトフォントまたはシステムフォントの適用

reference_image

SpriteFrames の一覧と、プロジェクトアセットからシーン内への参照画像配置

environment

エンジン・ネイティブパス、デバイス、エディタネットワーク、プログラミング設定、プラグインの検査

knowledge

組み込みのCocosワークフローガイダンスを、トピック別に検索

server

ローカルサービス状態と最近の操作メタデータの読取

preferences

プロジェクト:ローカルなツール選択の検査・無効・有効・リセット

iconfig

Claude Desktop, Cursor, VS Code, Windsurf のクライアント設定を生成

追加のワークフロー機能として、セッション対応 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

コマンド

目的

npm run check

ビルドファイルを追めず型チェック

npm run build

拡張機能をdist/にコンパル

npm run test:regression

ログレッション・テストをローカルで実こな

npm run test:smoke

リグレッション・テストとMCPトランスポート/ツール検知チェックを実行

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 を読ん、確認レーションゲート維持、ユーザー向き変更にはテストスドキメドを添付してください。

謝辞

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

ライセンス

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

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to directly control the Cocos Creator 3.8.x editor via MCP protocol, providing over 130 tools for scene, node, component, asset, and project operations.
      44
      -
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to interact with the Cocos Creator 3.8+ editor through standardized protocols for scene, node, component, prefab, asset, project, debugging, and server operations.
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to directly control the Cocos Creator game editor via MCP protocol, supporting scene management, node manipulation, component attachment, and asset management.
      3
      -
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI clients to control Cocos Creator editor projects, scenes, nodes, components, assets, Prefabs, building, and diagnostics via the MCP protocol.
      -