Funplay Unreal MCP — MCP-сервер для Unreal Editor
Связывает ИИ-клиент с запущенным Unreal Editor: агент сам расставляет актёры, собирает уровни и Blueprints, делает скриншоты. Нужен, когда хочется править сцену словами, а не мышью.
claude mcp add --env FUNPLAY_UNREAL_MCP_URL=<FUNPLAY_UNREAL_MCP_URL> --env UNREAL_MCP_URL=<UNREAL_MCP_URL> --env FUNPLAY_UNREAL_MCP_TOKEN=<FUNPLAY_UNREAL_MCP_TOKEN> --env UNREAL_MCP_TOKEN=<UNREAL_MCP_TOKEN> --transport stdio funplay-unreal-mcp -- npx -y funplay-unreal-mcpЧто делает Funplay Unreal MCP
Сервер состоит из двух частей. Внутри редактора работает плагин на чистом Python — компилировать ничего не надо, он живёт в Plugins/FunplayMCP/ и тянет за собой Python Editor Script Plugin. Снаружи стоит маленький Node.js-мост funplay-unreal-mcp, который подключает к серверу Claude, Codex, Cursor, Copilot, Windsurf, Cline, Zed или Gemini CLI.
Главный инструмент — execute_python: любой сниппет выполняется прямо в редакторе. Плюс search_api, describe_class и inspect_object читают документацию встроенного модуля unreal, поэтому агент опирается на настоящий API. По умолчанию открыт профиль core на 32 инструмента, в full их 97. Есть ресурсы вида unreal://project/context и шаблоны промптов вроде level_review.
Сервер слушает http://127.0.0.1:8765/, при занятом порте берёт свободный. Токен авторизации лежит в <YourProject>/Saved/FunplayMCP/funplay_mcp_settings.json, и без него POST-запросы отклоняются. Работает только внутри редактора: в собранную игру сервер не попадает. Проверки безопасности execute_python включены по умолчанию, обойти их можно флагом safety_checks=false для отдельного вызова.
Какие задачи решает
- расставить актёры и свет по текстовому описанию сцены
- собрать уровень и Blueprint без ручного перетаскивания
- сделать скриншот из Play-In-Editor и вернуть его агенту
- выполнить произвольный Python в редакторе, когда готового инструмента нет
- посмотреть реальную сигнатуру класса
unrealвместо догадок
Примеры запросов агенту
- Собери небольшую арену: пол, четыре стены, пара точечных источников света и Player Start в центре. Запусти Play-In-Editor и пришли скриншот.
- Вызови
get_project_infoи покажи, что за проект открыт. - Найди в API класс для работы со статическими мешами и опиши его методы.
Как установить Funplay Unreal MCP
Командой платформы
claude mcp add --env FUNPLAY_UNREAL_MCP_URL=<FUNPLAY_UNREAL_MCP_URL> --env UNREAL_MCP_URL=<UNREAL_MCP_URL> --env FUNPLAY_UNREAL_MCP_TOKEN=<FUNPLAY_UNREAL_MCP_TOKEN> --env UNREAL_MCP_TOKEN=<UNREAL_MCP_TOKEN> --transport stdio funplay-unreal-mcp -- npx -y funplay-unreal-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add funplay-unreal-mcp --env FUNPLAY_UNREAL_MCP_URL=<FUNPLAY_UNREAL_MCP_URL> --env UNREAL_MCP_URL=<UNREAL_MCP_URL> --env FUNPLAY_UNREAL_MCP_TOKEN=<FUNPLAY_UNREAL_MCP_TOKEN> --env UNREAL_MCP_TOKEN=<UNREAL_MCP_TOKEN> -- npx -y funplay-unreal-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"funplay-unreal-mcp": {
"command": "npx",
"args": [
"-y",
"funplay-unreal-mcp"
],
"env": {
"FUNPLAY_UNREAL_MCP_URL": "<FUNPLAY_UNREAL_MCP_URL>",
"UNREAL_MCP_URL": "<UNREAL_MCP_URL>",
"FUNPLAY_UNREAL_MCP_TOKEN": "<FUNPLAY_UNREAL_MCP_TOKEN>",
"UNREAL_MCP_TOKEN": "<UNREAL_MCP_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"funplay-unreal-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"funplay-unreal-mcp"
],
"env": {
"FUNPLAY_UNREAL_MCP_URL": "<FUNPLAY_UNREAL_MCP_URL>",
"UNREAL_MCP_URL": "<UNREAL_MCP_URL>",
"FUNPLAY_UNREAL_MCP_TOKEN": "<FUNPLAY_UNREAL_MCP_TOKEN>",
"UNREAL_MCP_TOKEN": "<UNREAL_MCP_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e FUNPLAY_UNREAL_MCP_URL=<FUNPLAY_UNREAL_MCP_URL> -e UNREAL_MCP_URL=<UNREAL_MCP_URL> -e FUNPLAY_UNREAL_MCP_TOKEN=<FUNPLAY_UNREAL_MCP_TOKEN> -e UNREAL_MCP_TOKEN=<UNREAL_MCP_TOKEN> funplay-unreal-mcp npx -y funplay-unreal-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Funplay Unreal MCP
Как установить Funplay Unreal MCP в Claude Code?
Сначала положите папку FunplayMCP/ в Plugins/ проекта и включите плагин в Edit → Plugins. Затем выполните `claude mcp add funplay-unreal-mcp -e FUNPLAY_UNREAL_MCP_TOKEN=<FUNPLAY_UNREAL_MCP_TOKEN> -e UNREAL_MCP_TOKEN=<UNREAL_MCP_TOKEN> -- npx -y funplay-unreal-mcp`. Токен и endpoint возьмите из Tools → Funplay MCP → Log Endpoint + Token.
Что делает Funplay Unreal MCP?
Даёт ИИ-ассистенту доступ к запущенному Unreal Editor через MCP: агент создаёт актёры, строит уровни и Blueprints, импортирует ассеты, запускает Play-In-Editor и снимает скриншоты. Основной путь — инструмент execute_python.
Сервер попадёт в собранную игру?
Нет, он работает только внутри редактора. Привязка идёт к 127.0.0.1, запросы без токена проекта отклоняются.
