Funplay MCP for Cocos
Расширение для Cocos Creator со встроенным MCP-сервером: агент строит интерфейс, правит сцены и делает скриншоты редактора
- 371 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент выполняет произвольный JavaScript в среде редактора и сцены, а защитные проверки обходятся
- Инструменты создают и удаляют узлы, префабы и файлы ресурсов в проекте, подтверждения вызовов нет
- Скриншоты и имитация ввода работают на уровне Electron и видят содержимое окон редактора
Установка
- Работает в
Ручная установка
git clone https://github.com/FunplayAI/funplay-cocos-mcp.git extensions/funplay-cocos-mcpВыполняется в папке проекта Cocos Creator. Основной способ — страница расширения в Cocos Store. После установки перезапустите Creator.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент выполняет произвольный JavaScript в среде редактора и сцены, а защитные проверки обходятся
- Инструменты создают и удаляют узлы, префабы и файлы ресурсов в проекте, подтверждения вызовов нет
- Скриншоты и имитация ввода работают на уровне Electron и видят содержимое окон редактора
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Funplay MCP for Cocos — расширение для редактора Cocos Creator 3.8 и новее. Оно запускает внутри редактора HTTP MCP-сервер, и ИИ-агент получает доступ к открытому проекту. Отдельный демон или внешний мост для этого не нужны. Подключаются десять клиентов, от Claude Code и Cursor до Codex и OpenCode. Главный инструмент называется execute_javascript. Параметр `context` задает среду: со значением `scene` код выполняется в активной сцене, а со значением `editor` — в редакторе. Через него агент строит иерархию интерфейса под Canvas, подключает компоненты Cocos и проверяет результат. Остальные инструменты вспомогательные: они работают с иерархией, префабами и ресурсами, читают логи и диагностику скриптов, а еще снимают скриншоты и имитируют мышь и клавиатуру. По умолчанию включен базовый профиль на 39 инструментов, полный открывает все 106, а в настраиваемом можно включать и отключать категории и отдельные инструменты. Помимо инструментов сервер публикует ресурсы о проекте, сцене, выделении и логах и четыре готовых промпта, например fix_script_errors. Меню Funplay, пункт MCP Server, настраивает нужного клиента одной кнопкой.
Для кого. Для разработчиков игр на Cocos Creator, которые хотят поручить агенту сборку интерфейса, правку сцен и проверку префабов прямо в редакторе.
Подходит, если
- Нужно собрать экран входа с полями логина и пароля и двумя кнопками, а затем проверить его на скриншоте
- Агент должен найти битые ссылки в префабах и зависимостях ресурсов проекта
- Скрипты проекта падают, и нужно собрать диагностику и логи, не копируя их вручную в чат
- Требуется проверить игровой сценарий: агент имитирует клики мышью и нажатия клавиш и снимает результат
- Вы подключаете сразу несколько клиентов и хотите настроить их кнопкой в панели редактора
Не подходит, если
- Вы работаете в Unity, Godot или Unreal Engine: расширение сделано только для Cocos Creator
- Нужны зависимости в самой игре: расширение работает только в редакторе и в готовую сборку ничего не добавляет
- Нельзя давать агенту выполнять произвольный JavaScript в редакторе: защитные проверки лишь блокируют очевидные вызовы
- Нужно подтверждение каждого вызова: встроенного переключателя одобрения в расширении нет
Пример запроса к агенту
Собери в текущей сцене экран входа с полями логина и пароля, кнопкой входа и кнопкой гостя, проверь иерархию и сделай скриншотMCP
- Транспорт
- http, stdio
- Авторизация
- не нужна
Переменные окружения
FUNPLAY_COCOS_MCP_URL- Адрес HTTP-сервера редактора для stdio-оболочки, например http://127.0.0.1:8765/
Ограничения
- Нужен Cocos Creator 3.8 или новее. Расширение только для редактора, в игру оно ничего не добавляет.
- Защитные проверки execute_javascript блокируют очевидные удаления файлов, пути за пределами проекта и child_process, но это не песочница. Параметр safety_checks: false отключает их.
- Файловые инструменты и ресурсы cocos://asset/path ограничены корнем активного проекта.
- Для новых проектов порт выбирается из диапазона 20000–29999. Если он занят, сервер уходит на соседний, и адрес в конфигурации клиента нужно брать из панели.
- Для глобальной установки расширения для всех проектов нужно повторить шаг для каждой версии Creator.
Как отключить. В меню Funplay, пункт MCP Server, отключите сервер. Чтобы убрать расширение, удалите папку extensions/funplay-cocos-mcp из проекта или глобальную копию в каталоге .CocosCreator/builtin-extensions, затем перезапустите Creator. Запись вида `cocos-<проект>-<хэш>` удалите из конфигурации клиента, а для Claude Code выполните `claude mcp remove` с этим именем.
Частые вопросы
Как установить MCP для Cocos Creator?
Поставьте расширение со страницы Cocos Store либо выполните `git clone https://github.com/FunplayAI/funplay-cocos-mcp.git extensions/funplay-cocos-mcp` в папке проекта и перезапустите Creator. Затем откройте меню Funplay, пункт MCP Server, и нажмите One-Click Configure для нужного клиента.
Как подключить его к Claude Code?
Проще всего кнопкой One-Click Configure в панели: расширение запишет запись в ~/.claude.json в области корня Git вашего проекта. Вручную добавляют блок mcpServers с type http и адресом из панели, например http://127.0.0.1:8765/.
Чем отличаются профили core и full?
Профиль core открывает 39 самых нужных инструментов и меньше засоряет список. Профиль full открывает все 106. Через custom можно включать и выключать категории и отдельные инструменты и сохранять свои профили.
Что делает execute_javascript?
Выполняет JavaScript в среде сцены (`context: scene`) или редактора (`context: editor`). Консольный вывод каждого вызова собирается и возвращается агенту вместе с длительностью.
Нужен ли stdio-режим?
Если клиент хочет локальную команду, установите оболочку командой `npm install -g funplay-cocos-mcp` и укажите адрес в переменной FUNPLAY_COCOS_MCP_URL. Оболочка передает трафик в HTTP-эндпоинт редактора, который должен быть уже запущен.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыCocos Creator MCP Server
Cocos Creator MCP Server Plugin
MCP-сервер как расширение редактора Cocos Creator: агент управляет сценами, нодами, компонентами, префабами и ресурсами проекта
MCP-сервер внутри редактора Unity: агент создает сцены и скрипты, запускает play mode и проверяет игру скриншотами
MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
MCP-сервер на 157 инструментов для Godot 4: агент правит сцены и проект, запускает игру, меняет узлы в работе и пишет скрипты на GDScript и .NET
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Funplay MCP for Cocos (эта запись) | нет | не нужна | 371 | |
| Cocos Creator MCP Server | нет | не нужна | 1 468 | расширение того же типа с другим набором инструментов и своей панелью |
| MCP Unity | нет | не нужна | 2 006 | связывает агента с редактором Unity, а не Cocos Creator |
Коротко о README
Проект отдельно сравнивает себя с версией того же сервера для Unity и разбирает ограничения редактора Cocos. Полный перечень инструментов профиля core идет в конце.