MCP Bridge для Cocos Creator

MCP Bridge for Cocos Creator

Плагин для Cocos Creator 2.4.x запускает локальный сервер, и агент правит сцены, префабы, ресурсы и собирает проект через MCP

  • 236 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

Почему такой уровень

  • Агент создает, меняет и удаляет узлы, скрипты, префабы и ресурсы проекта, а также запускает пункты меню и сборку
  • Локальный HTTP-сервер редактора принимает команды, поэтому порт на `127.0.0.1` нужно держать закрытым от посторонних программ
  • Удаление и перемещение ресурсов меняет файлы проекта, поэтому перед массовой правкой стоит сделать коммит в Git
Все причины и проверки

firekula/mcp-bridge

Установка

Ручная установка

{
  "mcpServers": {
    "mcp-bridge": {
      "command": "node",
      "args": ["[путь установки плагина]/dist/mcp-proxy.js"]
    }
  }
}

Подставьте абсолютный путь к dist/mcp-proxy.js. Панель плагина умеет записать эту конфигурацию сама для Claude Desktop, Cline, Roo Code и Trae.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент создает, меняет и удаляет узлы, скрипты, префабы и ресурсы проекта, а также запускает пункты меню и сборку
  • Локальный HTTP-сервер редактора принимает команды, поэтому порт на `127.0.0.1` нужно держать закрытым от посторонних программ
  • Удаление и перемещение ресурсов меняет файлы проекта, поэтому перед массовой правкой стоит сделать коммит в Git

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

MCP Bridge устанавливается в папку `packages` проекта Cocos Creator 2.4.x и запускает внутри редактора локальный HTTP-сервер (по умолчанию порт 8200, при занятости берется следующий). Адрес привязан к `127.0.0.1`. К серверу подключается MCP-клиент через небольшой stdio-прокси `dist/mcp-proxy.js`. Агент получает больше тридцати инструментов для работы с редактором. Инструменты охватывают узлы сцены (получение, создание, изменение), компоненты (добавление, удаление, чтение), скрипты (создание, чтение, запись, проверка синтаксиса), ресурсы (создание, перемещение, удаление, сведения), материалы, текстуры и частицы. Отдельно описан офлайн-режим правки префабов (`.prefab`) и сцен (`.fire`): он создает ресурсы с нуля, клонирует с пересчетом ссылок и меняет порядок отрисовки. Есть пакетное выполнение, глобальный поиск, поиск ссылок на узел или ресурс, чтение консоли, отмена и повтор, запуск пунктов меню и сборка проекта через `Editor.Builder`. Устойчивость обеспечивают очередь команд (до 100 штук, при превышении ответ 429), таймауты IPC и защита свойств компонентов от правок, которые ломают редактор. Параметры вроде `operation` вместо `action` сервер принимает как алиасы, чтобы сгладить ошибки моделей. Пока проект не выбран вызовом `set_active_instance`, доступны только два базовых инструмента. Панель настроек умеет прописать конфигурацию для Claude Desktop, Cline, Roo Code и Trae.

Для кого. Разработчикам игр на Cocos Creator 2.4, которые хотят поручить агенту рутину в редакторе: расстановку узлов, правку префабов и сборку.

Подходит, если

  • Нужно массово изменить узлы сцены и компоненты, а ручной перебор в редакторе занимает часы
  • Префаб или сцену `.fire` надо поправить офлайн: сменить ссылки, порядок отрисовки, клонировать иерархию
  • Агенту поручают создать скрипт компонента, проверить синтаксис и прочитать консоль редактора
  • Перед правкой надо узнать, что ссылается на конкретный узел или ресурс, включая подресурсы текстуры
  • Сборку проекта запускают из чата, а редактор не должен вылетать при ошибке: предусмотрена защита

Не подходит, если

  • Проект на Cocos Creator 3.x: плагин рассчитан на 2.4.x и использует API этой версии редактора
  • Нужен MCP для Unity или Unreal: плагин работает только внутри редактора Cocos Creator
  • Работа с редактором идет без включенного сервера: сначала его запускают из панели расширения
  • Нужна документация на английском: основное описание и заметки написаны по-китайски

Пример запроса к агенту

Через mcp-bridge создай в сцене узел Player со спрайтом и скриптом движения, проверь синтаксис скрипта и покажи ошибки консоли редактора

MCP

Транспорт
stdio
Авторизация
не нужна

Ограничения

  • Подходит только для Cocos Creator 2.4.x: плагин использует особые API редактора и может не работать на новых и старых версиях.
  • Нужна сборка: после копирования в `packages` выполняют `npm install` и `npm run build` (`esbuild` с целью es2018 для `Electron` 9.x), затем запускают сервер из меню редактора.
  • Файл лицензии не определен однозначно (GitHub показывает NOASSERTION), поэтому условия использования стоит уточнить у автора.
  • Документация на китайском. Последний коммит датирован июлем 2026 года.

Как отключить. Остановите сервер в панели расширения и удалите папку mcp-bridge из packages проекта. Запись mcp-bridge в mcpServers клиента также уберите.

Частые вопросы

Как подключить Claude к Cocos Creator через MCP Bridge?

Запустите сервер в панели расширения, затем в разделе «MCP-конфигурация» выберите клиента и нажмите кнопку автоматической настройки. Вручную добавьте в `mcpServers` запись с command `node` и путем к `dist/mcp-proxy.js`.

Какие версии Cocos Creator поддерживаются?

Только 2.4.x. Плагин использует API редактора этой версии и может не заработать на других.

Что делает офлайн-правка префабов?

Меняет файлы `.prefab` и `.fire` без открытия ресурса в редакторе: создает скелет с нуля, клонирует с пересчетом ссылок, переставляет порядок отрисовки и связывает вложенные массивы.

Что произойдет при слишком большой очереди команд?

Очередь вмещает до 100 команд и выполняет их по одной. Лишние запросы получают ответ `HTTP` 429, поэтому редактор не зависает.

Для чего в репозитории шесть скиллов Claude Code?

Это рабочий процесс разработки самого плагина: `/mcp-define`, `/mcp-architect`, `/mcp-execute`, `/mcp-verify` и дополнительные `/mcp-rules` и `/mcp-refactor`. Для обычной работы с редактором они не нужны.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Cocos Creator MCP Server

Cocos Creator MCP Server Plugin

MCP-сервер как расширение редактора Cocos Creator: агент управляет сценами, нодами, компонентами, префабами и ресурсами проекта

MCP-серверРасширенный доступ1,5 тыс.Звезды репозитория

Расширение для Cocos Creator со встроенным MCP-сервером: агент строит интерфейс, правит сцены и делает скриншоты редактора

MCP-серверШирокий доступ394Звезды репозитория
Официальный

Официальный MCP-сервер редактора PlayCanvas: 130 инструментов для сцен, скриптов и ассетов с запуском и проверкой скриншотом

MCP-серверШирокий доступ151Звезды репозитория

MCP-сервер внутри редактора Unity: агент создает сцены и скрипты, запускает play mode и проверяет игру скриншотами

MCP-серверШирокий доступ303Звезды репозитория

Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их

ПлагинРасширенный доступ10,9 тыс.Звезды репозитория

Пакет Unity с локальным мостом в редакторе: агент через MCP управляет сценами, префабами, сборками и тестами

MCP-серверШирокий доступ257Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
MCP Bridge для Cocos Creator (эта карточка)нетне нужна236
Funplay MCP for Cocosнетне нужна394расширение со встроенным MCP-сервером для интерфейса и сцен, а здесь версия Cocos Creator 2.4.x и офлайн-правка префабов
Cocos Creator MCP Serverнетне нужна1 486MCP-сервер как расширение редактора для управления сценами и ресурсами, а MCP Bridge рассчитан на 2.4.x и включает очередь команд и защиту свойств

Коротко о README

Страница перечисляет возможности плагина (сервер, операции с узлами, ресурсами, компонентами, скриптами, офлайн-правка префабов, очередь команд, защита свойств) и шесть навыков Claude Code для разработки самого плагина. Затем идут версия редактора, установка копированием в `packages`, сборка, запуск на порту 8200, подключение клиентов автоматически или вручную и схема каталогов проекта.

Бейдж для README

Сообщить о проблеме