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 в редакторе; проверки безопасности отключаемы; инструменты работают без подтверждения; файловые операции ограничены корнем проекта.

Настройка клиентов

codex
{
    "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 для запуска произвольных команд.

Риск: medium Лицензия: Apache-2.0 ★ 39 555

Windows-MCP

Управление компьютером с Windows: окна, приложения, ввод и чтение экрана.

Риск: high Лицензия: MIT ★ 11 608

agent-device

Слой управления мобильными, веб-, ТВ- и десктопными приложениями для агентов.

Риск: medium Лицензия: MIT ★ 5 295

Источники