Funplay MCP for Unity
MCP-сервер внутри редактора Unity: агент создает сцены и скрипты, запускает play mode и проверяет игру скриншотами
- 275 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- `execute_code` запускает произвольный C# в редакторе и может менять и удалять ассеты проекта
- Все инструменты выполняются без подтверждения внутри пакета, защитные проверки не заменяют песочницу
- Локальный HTTP-сервер слушает порт на 127.0.0.1 и принимает команды любого подключенного клиента
Установка
- Работает в
Ручная установка
openupm add com.gamebooom.unity.mcpУстановка через OpenUPM, версии пакета видны в Package Manager. Без OpenUPM добавьте адрес https://github.com/FunplayAI/funplay-unity-mcp.git в Window > Package Manager > Add package from git URL.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- `execute_code` запускает произвольный C# в редакторе и может менять и удалять ассеты проекта
- Все инструменты выполняются без подтверждения внутри пакета, защитные проверки не заменяют песочницу
- Локальный HTTP-сервер слушает порт на 127.0.0.1 и принимает команды любого подключенного клиента
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Funplay MCP for Unity ставится в проект как пакет Unity и поднимает HTTP-сервер MCP прямо в открытом редакторе. Claude Code, Cursor, Codex и другие клиенты подключаются к нему по адресу на 127.0.0.1 и работают с живым проектом: создают объекты и компоненты, правят свойства через SerializedObject, пишут и патчат скрипты, назначают материалы, ищут битые ссылки. Главный инструмент называется `execute_code`. Агент присылает фрагмент C#, пакет компилирует его в памяти через Roslyn и запускает в потоке редактора, не оставляя файлов в `Assets/`. Шаблон `IFunplayCommand` регистрирует созданные и измененные объекты в Undo и возвращает журнал изменений, так что агент видит все изменения. Для узких задач есть отдельные инструменты, они дешевле для модели. По умолчанию пакет открывает набор `core` из 40 инструментов, полный набор `full` содержит 180 в 42 модулях. Сервер отдает ресурсы с состоянием проекта (сцена, выделение, ошибки компиляции, консоль) и готовые промпты вроде `verify_compilation` и `create_playable_prototype`. В play mode агент имитирует клавиатуру и мышь, снимает скриншоты и читает журналы. Окно сервера в меню Funplay записывает конфигурацию в выбранный клиент одним нажатием. Для Claude Code, Cursor, Codex, OpenCode и DeepSeek Harness есть вариант настройки вместе со скиллами: он дополнительно ставит в проект скиллы `unity-mcp-workflow` и `unity-ui-composition`.
Для кого. Для разработчиков игр на Unity, которые хотят поручить Claude Code, Cursor или Codex рутину в редакторе: сборку сцен, интерфейсов и прототипов с проверкой в play mode.
Подходит, если
- Нужен прототип по одной фразе: сцена, скрипты, интерфейс со счетом и экран конца игры
- Интерфейс на uGUI должен подстраиваться под портретную и ландшафтную ориентацию, и агенту нужен скилл `unity-ui-composition`
- После правки кода надо убедиться, что проект компилируется, и пройти уровень в play mode с имитацией клавиш и снимками экрана
- Много однотипных правок: добавить компонент десяткам объектов или проверить битые ссылки на ассеты
- В проекте есть свои рабочие процессы, и их удобно описать файлами `mcp-prompts/*.md` в корне проекта
Не подходит, если
- Нужны инструменты в собранной игре: пакет работает только в редакторе и компонентов в рантайм не добавляет
- Версия Unity ниже 2022.3: пакет требует 2022.3 или новее
- Вы хотите песочницу для `execute_code`: защитные проверки блокируют очевидно разрушительные фрагменты, но полной изоляции нет
- Требуется генерация 3D-моделей, текстур или звука внутри пакета: встроенных генераторов ассетов в нем нет
Пример запроса к агенту
Через Funplay MCP создай сцену со змейкой на поле 10 на 10: еда, счет, экран конца игры. Затем запусти play mode и сделай скриншот.MCP
- Транспорт
- http
- Авторизация
- не нужна
Ограничения
- Пакет работает только в редакторе Unity 2022.3 и новее и не добавляет компонентов в собранную игру.
- Каждый открытый проект получает свой порт из диапазона 20000–29999, а запись в конфигурации клиента называется по папке проекта. Если порт занят, окно сервера покажет запасной и заблокирует автонастройку, пока вы не закрепите порт.
- Защитные проверки `execute_code` включены по умолчанию и режут явно разрушительные фрагменты, широкую запись через `System.IO` и пути вне проекта. Полной песочницы они не дают, и клиент может отключить проверки в отдельном вызове.
- Все инструменты выполняются сразу, дополнительного подтверждения в пакете нет. Решения о правах принимает клиент агента.
- Встроенных генераторов изображений, мешей и звука нет, их агент собирает сам через внешние API внутри `execute_code`.
Как отключить. Остановите сервер в окне MCP Server меню Funplay и удалите запись `funplay-<project>` из конфигурации клиента. Пакет убирается через Package Manager. Если вы ставили скиллы, удалите `unity-mcp-workflow` и `unity-ui-composition` из папки скиллов проекта.
Частые вопросы
Как подключить Unity к Claude Code через MCP?
Добавьте пакет из Git URL в Package Manager, запустите сервер из пункта MCP Server меню Funplay и нажмите Configure для Claude Code. Пакет запишет в конфигурацию HTTP-сервер с адресом вида http://127.0.0.1:порт/. Для проверки попросите агента вызвать `get_scene_info`.
Чем core отличается от full в Funplay MCP?
Набор `core` содержит 40 частых инструментов и включен по умолчанию, полный `full` открывает все 180. Состав обоих наборов можно править в окне Tool Exposure меню Funplay.
Что делает execute_code и безопасно ли это?
Инструмент компилирует присланный C# в памяти и запускает его в редакторе. Защитные проверки включены по умолчанию и блокируют явно разрушительные фрагменты и широкую запись на диск, но песочницей не служат. Настройки лежат в пункте MCP Settings меню Funplay.
Можно ли вести несколько проектов Unity одновременно?
Да. Новый проект получает собственный порт из диапазона 20000–29999, а запись в клиенте называется funplay-имя_проекта. Проект, обновленный с прежней версии, сохраняет старый порт, и кнопка Use Per-Project Port переключает его на отдельный.
Какие клиенты поддерживаются?
Кнопка Configure умеет писать конфигурацию для Claude Code, Claude Desktop, Cursor, Codex, OpenCode, VS Code, Kiro, Trae, Kimi Code, LM Studio, DeepSeek Harness и Antigravity. Любой другой клиент с поддержкой MCP по HTTP настраивается вручную по примерам из документации.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыПакет Unity: редактор сам отдает MCP по HTTP, а агент и командная строка управляют сценами, ассетами и сборкой
Расширение для Cocos Creator со встроенным MCP-сервером: агент строит интерфейс, правит сцены и делает скриншоты редактора
Управление редактором Unity из агента через MCP: сцены и объекты, C#-скрипты, ассеты, тесты, профилирование и сборка
MCP-сервер, который связывает AI-агента с редактором Unity: управление сценой, объектами, пакетами и ресурсами проекта
MCP-сервер для Unity: управление сценой, объектами, компонентами, сборками и профилировкой из агента
Плагин Unity с MCP-сервером, скиллами и CLI: агент управляет сценами, ассетами, скриптами и тестами в редакторе Unity
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Funplay MCP for Unity (эта запись) | нет | не нужна | 275 | |
| Unity MCP Server | нет | не нужна | 530 | другой MCP-сервер для Unity, а здесь упор на `execute_code` и компактный набор `core` из 40 инструментов |
| MCP Unity | нет | не нужна | 2 009 | тоже связывает Unity с агентом, здесь же сервер встроен в редактор и работает без внешнего процесса |
Коротко о README
Страница репозитория открывается установкой через Git URL или OpenUPM и тремя шагами: запуск сервера, настройка клиента, проверка связи. Дальше идут таблицы сравнения с Coplay unity-mcp и Unity AI Assistant, разделы про `execute_code`, ресурсы, промпты и перечень инструментов по категориям.