MCP Bridge для Cocos Creator
MCP Bridge for Cocos Creator
Плагин для Cocos Creator 2.4.x запускает локальный сервер, и агент правит сцены, префабы, ресурсы и собирает проект через MCP
- 236 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент создает, меняет и удаляет узлы, скрипты, префабы и ресурсы проекта, а также запускает пункты меню и сборку
- Локальный HTTP-сервер редактора принимает команды, поэтому порт на `127.0.0.1` нужно держать закрытым от посторонних программ
- Удаление и перемещение ресурсов меняет файлы проекта, поэтому перед массовой правкой стоит сделать коммит в Git
Установка
- Работает в
Ручная установка
{
"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: агент управляет сценами, нодами, компонентами, префабами и ресурсами проекта
Расширение для Cocos Creator со встроенным MCP-сервером: агент строит интерфейс, правит сцены и делает скриншоты редактора
Официальный MCP-сервер редактора PlayCanvas: 130 инструментов для сцен, скриптов и ассетов с запуском и проверкой скриншотом
MCP-сервер внутри редактора Unity: агент создает сцены и скрипты, запускает play mode и проверяет игру скриншотами
Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
Пакет Unity с локальным мостом в редакторе: агент через MCP управляет сценами, префабами, сборками и тестами
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| MCP Bridge для Cocos Creator (эта карточка) | нет | не нужна | 236 | |
| Funplay MCP for Cocos | нет | не нужна | 394 | расширение со встроенным MCP-сервером для интерфейса и сцен, а здесь версия Cocos Creator 2.4.x и офлайн-правка префабов |
| Cocos Creator MCP Server | нет | не нужна | 1 486 | MCP-сервер как расширение редактора для управления сценами и ресурсами, а MCP Bridge рассчитан на 2.4.x и включает очередь команд и защиту свойств |
Коротко о README
Страница перечисляет возможности плагина (сервер, операции с узлами, ресурсами, компонентами, скриптами, офлайн-правка префабов, очередь команд, защита свойств) и шесть навыков Claude Code для разработки самого плагина. Затем идут версия редактора, установка копированием в `packages`, сборка, запуск на порту 8200, подключение клиентов автоматически или вручную и схема каталогов проекта.