Funplay Cocos MCP
Funplay Cocos MCP — MCP-сервер сообщества (автор — FunplayAI). Мост к локальному MCP-серверу редактора Cocos Creator. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- FunplayAI
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- javascript
Уровень риска: high
execute_javascript выполняет произвольный JavaScript в редакторе; проверки безопасности отключаемы; инструменты работают без подтверждения; файловые операции ограничены корнем проекта.
Настройка клиентов
{
"code": "[mcp_servers.funplay_cocos]\nurl = \"http://127.0.0.1:8765/\"",
"file": "~/.codex/config.toml",
"lang": "toml",
"notes": "Дословно из README; замените имя и порт на значения из панели",
"verified": "docs"
}
Что умеет
Funplay MCP for Cocos — расширение для редактора Cocos Creator 3.8+ под лицензией MIT. Оно встраивает HTTP MCP-сервер прямо в редактор, и ИИ-ассистенты (Claude Code, Cursor, Codex, VS Code Copilot, OpenCode и другие) могут изучать запущенный проект Cocos и управлять им.
Главный инструмент — execute_javascript. С параметром context: "scene" он выполняет JavaScript в активной сцене, с context: "editor" — в контексте самого редактора. Например, ассистент может собрать экран входа с полями логина и пароля, добавить компоненты, проверить иерархию и сделать скриншот.
Всего в профиле full 106 инструментов:
- сцена и узлы: иерархия, поиск и создание узлов, трансформации, компоненты и их свойства;
- ассеты и префабы: просмотр, зависимости, проверка ссылок, дублирование;
- интерфейс, камеры, анимации: создание Canvas, надписей, кнопок, спрайтов;
- файлы: чтение, запись, замена и поиск в пределах корня проекта;
- диагностика: ошибки скриптов, логи, проверка сцены, снимок производительности;
- запуск и ввод: предпросмотр, пауза и масштаб времени, имитация кликов, перетаскивания и клавиш;
- скриншоты редактора, сцены, игры и предпросмотра.
По умолчанию включён профиль core на 39 инструментов, а в профиле custom можно включать и выключать категории и отдельные инструменты. Есть ресурсы вроде cocos://project/context и cocos://scene/active, а также готовые подсказки для исправления скриптов и проверки сцены.
Кому подойдёт
- Разработчикам игр на Cocos Creator, которые хотят собирать интерфейсы и сцены с помощью ИИ-ассистента.
- Командам, у которых уже есть Funplay MCP for Unity: проект для Cocos развивается в том же направлении.
Другие серверы для игровых движков — в категории 3D и геймдев.
Установка
Рекомендуемый способ — установить расширение со страницы в Cocos Store. Для локальной разработки репозиторий клонируют в каталог расширений проекта:
cd /path/to/your-cocos-project
mkdir -p extensions
git clone https://github.com/FunplayAI/funplay-cocos-mcp.git extensions/funplay-cocos-mcpЗатем перезапустите Cocos Creator или перезагрузите расширения. Кнопка Install for All Projects в окне Funplay > MCP Settings ставит расширение глобально для текущей версии Creator: она скачивает свежий релиз с GitHub и сверяет SHA256SUMS.txt.
Сервер включается в меню Funplay > MCP Server. Новые проекты получают постоянный порт в диапазоне 20000–29999, а точный адрес показан в панели. Там же есть настройка клиентов в один клик.
Подключение к клиентам
Конфиги ниже приведены дословно из README как запасной вариант для ручной настройки. Замените в них имя funplay_cocos и порт 8765 на имя и адрес из панели. Подробнее — в инструкции как подключить MCP.
{
"mcpServers": {
"funplay_cocos": {
"type": "http",
"url": "http://127.0.0.1:8765/"
}
}
}Для Codex настройка в один клик пишет в $CODEX_HOME/config.toml (по умолчанию ~/.codex/config.toml), для OpenCode — в ~/.config/opencode/opencode.json. Клиентам, которым нужен локальный stdio, подойдёт обёртка npm install -g funplay-cocos-mcp: она пересылает запросы на HTTP-адрес редактора.
Проверка
Начните с безопасных запросов: попросите вызвать get_project_info и кратко описать проект, прочитать ресурс cocos://project/context или вернуть имя активной сцены через execute_javascript. Для отладки транспорта README предлагает команды:
curl http://127.0.0.1:8765/health
curl http://127.0.0.1:8765/toolsПримеры задач
Создай в текущей сцене экран входа с полями логина и пароля, кнопкой входа и гостевым входом. Сначала используй execute_javascript, затем проверь иерархию и сделай скриншот.Найди ошибки в скриптах проекта, покажи контекст диагностики и предложи исправления.Риски
- Выполнение кода.
execute_javascriptзапускает произвольный JavaScript в сцене и в редакторе. Проверки безопасности включены по умолчанию и блокируют очевидные опасные шаблоны (удаление файлов,child_process, выход за пределы путей), но README прямо называет их ограничителем, а не песочницей: вызов может отключить их параметромsafety_checks: false. - Нет подтверждений. Все включённые инструменты выполняются сразу, отдельного переключателя одобрения в расширении нет. Отключайте лишние инструменты в окне Tool Exposure.
- Запись файлов. Файловые инструменты могут менять и удалять ассеты, но ограничены корнем активного проекта. Держите проект в системе контроля версий.
- Только редактор. Расширение автоматизирует Cocos Creator и не добавляет зависимостей в итоговую сборку игры.
Частые вопросы
Нужен ли отдельный процесс или Python?
Нет. Сервер работает внутри редактора Cocos Creator; npm-обёртка нужна только клиентам, которые поддерживают лишь stdio.
Что делать, если порт занят?
Сервер сам переходит на следующий свободный порт, а панель и настройка клиентов используют фактический адрес. Порт можно закрепить кнопкой Pin Current Port.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
commands
Сервер из UI-TARS-desktop для запуска произвольных команд.
Windows-MCP
Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.
agent-device
Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.
MCP-сервер для анализа сбоев в WinDbg
Анализ аварийных дампов Windows через WinDbg и CDB.