Funplay Cocos MCP — MCP-сервер для Claude Code и Cocos Creator
Встраивает MCP-сервер прямо в редактор Cocos Creator, чтобы ИИ-ассистент видел запущенный проект и управлял им.
claude mcp add --env FUNPLAY_COCOS_MCP_URL=<FUNPLAY_COCOS_MCP_URL> --env FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS=<FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS> --transport stdio funplay-cocos-mcp -- npx -y funplay-cocos-mcpЧто делает Funplay Cocos MCP
Расширение ставится в проект Cocos Creator и поднимает HTTP MCP-сервер внутри редактора. Дальше ассистент вызывает инструмент execute_javascript с контекстом scene — код выполняется в активной сцене и рантайме, или с контекстом editor — в контексте редактора. Так можно построить иерархию UI под активным Canvas, навесить компоненты, посмотреть результат и снять скриншот для проверки.
Клиентов подключают вручную или через окно настроек с готовыми конфигами. Для stdio-моста нужен адрес сервера: переменная FUNPLAY_COCOS_MCP_URL задаёт URL, FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS — таймаут. Без запущенного редактора и открытого проекта мост подключать некуда, потому что сервер живёт внутри Cocos Creator, а не отдельным процессом.
Новые проекты получают порт в диапазоне 20000–29999, сохранённые конфигурации держат свой. Если порт занят чужим слушателем, расширение уходит на следующий свободный, поэтому перед настройкой клиента стоит зафиксировать порт кнопкой **Pin Current Port**. Расширение можно поставить глобально для всех проектов одной версии Creator — тогда копию в extensions/ лучше убрать, иначе MCP Settings покажет предупреждение о дубликате.
Какие задачи решает
- построить UI-иерархию под активным Canvas из промпта
- навесить компоненты Cocos на объекты сцены
- выполнить JS в контексте редактора или рантайма
- снять скриншот сцены для проверки результата
- подключить ИИ-клиент к редактору одной командой
Примеры запросов агенту
- Собери экран логина: поля логина и пароля, кнопка входа, проверь иерархию под Canvas
- Выполни этот скрипт в контексте сцены и покажи, что получилось на скриншоте
- Посмотри текущую сцену и скажи, какие компоненты висят на корневых узлах
Как установить Funplay Cocos MCP
Командой платформы
claude mcp add --env FUNPLAY_COCOS_MCP_URL=<FUNPLAY_COCOS_MCP_URL> --env FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS=<FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS> --transport stdio funplay-cocos-mcp -- npx -y funplay-cocos-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add funplay-cocos-mcp --env FUNPLAY_COCOS_MCP_URL=<FUNPLAY_COCOS_MCP_URL> --env FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS=<FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS> -- npx -y funplay-cocos-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"funplay-cocos-mcp": {
"command": "npx",
"args": [
"-y",
"funplay-cocos-mcp"
],
"env": {
"FUNPLAY_COCOS_MCP_URL": "<FUNPLAY_COCOS_MCP_URL>",
"FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS": "<FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"funplay-cocos-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"funplay-cocos-mcp"
],
"env": {
"FUNPLAY_COCOS_MCP_URL": "<FUNPLAY_COCOS_MCP_URL>",
"FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS": "<FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FUNPLAY_COCOS_MCP_URL=<FUNPLAY_COCOS_MCP_URL> -e FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS=<FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS> funplay-cocos-mcp npx -y funplay-cocos-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Funplay Cocos MCP
Как установить Funplay Cocos MCP в Claude?
Сначала поставьте расширение в проект Cocos Creator и запустите сервер через Funplay > MCP Server. Затем выполните claude mcp add funplay-cocos-mcp -- npx -y funplay-cocos-mcp. Если нужны адрес и таймаут, добавьте их переменными: `claude mcp add --env FUNPLAY_COCOS_MCP_URL=<FUNPLAY_COCOS_MCP_URL> --env FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS=<FUNPLAY_COCOS_MCP_TIMEOUT_SECONDS> --transport stdio funplay-cocos-mcp -- npx -y funplay-cocos-mcp`.
Что делает Funplay Cocos MCP?
Поднимает MCP-сервер внутри редактора Cocos Creator и даёт ассистенту доступ к запущенному проекту. Основной инструмент — execute_javascript с контекстами scene и editor.
Нужен ли запущенный Cocos Creator?
Да, сервер встроен в редактор, а не работает отдельным процессом. Клиент подключается к тому URL, который показан в окне Funplay > MCP Server.
