Roblox Studio MCP

MCP-сервер для Roblox Studio. 29 инструментов через push-мост, каждая запись пакетируется и отменяется одним шагом. MIT.

Установка

1. Плагин Studio

npx -y @el4cteo/rbx-studio-mcp --install-plugin

Или скачайте StudioMCP.rbxmx из Releases в папку плагинов Studio.

2. Сервер, в любом используемом вами клиенте:

claude mcp add roblox-studio -- npx -y @el4cteo/rbx-studio-mcp

codex mcp add roblox-studio -- npx -y @el4cteo/rbx-studio-mcp

Или в ~/.codex/config.toml:

[mcp_servers.roblox-studio]
command = "npx"
args = ["-y", "@el4cteo/rbx-studio-mcp"]

~/.cursor/mcp.json (глобально) или .cursor/mcp.json (для проекта):

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "roblox-studio": {
      "type": "local",
      "command": ["npx", "-y", "@el4cteo/rbx-studio-mcp"],
      "enabled": true
    }
  }
}

claude_desktop_config.json:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

.vscode/mcp.json:

{
  "servers": {
    "roblox-studio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

~/.gemini/settings.json:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "roblox-studio": {
      "command": "npx",
      "args": ["-y", "@el4cteo/rbx-studio-mcp"]
    }
  }
}

3. Откройте Studio, примите запрос 127.0.0.1, проверьте кнопку панели инструментов Studio MCP. Проверьте с помощью studio_status.

4. Для debug включите Debugger Luau API в File → Beta Features, затем перезапустите Studio. Всё остальное работает без этого; точки останова — нет, потому что ScriptDebuggerService не регистрируется, пока это не включено.

Порт по умолчанию — 44755 — --port или ROBLOX_STUDIO_MCP_PORT, совпадает с виджетом плагина. Только loopback.

Несколько агентов одновременно работают. Зарегистрируйте это в любом количестве клиентов — две сессии Claude, Claude плюс Cursor, что угодно. Плагин подключается к одному порту, поэтому первый запущенный сервер владеет им, а остальные автоматически проксируются через него. Настраивать ничего не нужно, и второго подключения к Studio нет.

Каждый агент сохраняет свою цель: set_active_studio привязывается к клиенту, поэтому два агента могут одновременно работать с двумя открытыми местами, и ни один не может перенацелить другого. Передайте studioId в одном вызове, чтобы обратиться к другому месту, не меняя свой выбор по умолчанию.

Изоляция осуществляется на уровне MCP-подключения, и субагенты разделяют цель родителя — это измерено, а не предполагается. Субагент, вызывающий set_active_studio, перенацеливает своего родителя и его собратьев, молча: последующие вызовы всё равно выполняются, просто против неправильного места. Вместо этого давайте субагентам явный studioId в каждом вызове. Ничто в канале не отличает субагента от его родителя, так что это рекомендация, а не то, что сервер может принудительно обеспечить.

Related MCP server: Roblox Studio MCP

Инструменты

Подводные камни: debug требует API debugger Luau в File → Beta Features. Эмуляция device сохраняется до device op="stop". Во время playtest подключаются две сессии — передавайте studioId явно, используя сессию редактирования для всего, что должно сохраниться.

Пакетирование

Каждый инструмент записи принимает массив. Редактирование десяти скриптов, удаление двухсот деталей или привязка целой карты — это один вызов, а не цикл.

Ограничение на modify действует на записи, а не на цели — одна запись может привязать пятьсот деталей, так что сочетайте её с find и измените целое место одним вызовом.

Что это даёт помимо скорости:

• Один Ctrl+Z. Пакет выполняется внутри одной записи ChangeHistoryService, названной по имени инструмента. Десять правок скриптов отменяются одним шагом, а не десятью.

• Всё или ничего. Всё читается и преобразуется в памяти до записи, поэтому поиск, не находящий ничего — или находящий дважды — завершается ошибкой, оставляя место нетронутым, а не наполовину отредактированным.

• Вложенность. create принимает children, поэтому целая модель приходит одним вызовом. Путь нового экземпляра неизвестен, пока он не существует, а одноимённые соседи делают его угадывание ненадёжным.

Параллельные вызовы инструментов тоже работают — ответы привязаны к идентификатору запроса, поэтому несколько вызовов за один ход выполняются одновременно. Предпочитайте пакет, где он есть: параллельные вызовы — это N обращений и N шагов отмены, пакет — по одному каждого.

Сравнение с существующими

• Push, а не опрос. Поток SSE вместо опроса с интервалом 500 мс. 50 последовательных обращений: 13.6 мс в среднем против 25.8 мс, 12.8 мс медиана против 29.9 мс. Воспроизведите с помощью node scripts/latency.mjs --count 50 --compare.

• Безопасные правки скриптов. ScriptEditorService:UpdateSourceAsync, а не script.Source — ваш несохранённый буфер редактора сохраняется.

• Один Ctrl+Z на действие через ChangeHistoryService.

• 29 инструментов, ~16k токенов схемы, против 43–51 в других местах. Курсорная пагинация, ограничения, с detail: concise | standard | full.

• Живой дамп API для проверки свойств, так что опечатки получают подсказки (Anchorred → Anchored).

• Несколько агентов, одна Studio, каждый со своей целью — не нужен id в каждом вызове, и ни один агент не может перенацелить другого. Встроенный сервер достигает той же изоляции, делая studio_id обязательным везде и удаляя set_active_studio; здесь сохраняется значение по умолчанию, поэтому одной открытой Studio не нужен id вообще.

Здесь не реализовано: генерация ландшафта, AI-сеток и материалов.

Безопасность

Привязывается к 127.0.0.1, отклоняет запросы с Origin и требует заголовок, который браузер не может установить между источниками — закрывая дыру DNS-rebinding. Studio предоставляет HTTP для каждого плагина и каждого URL, поэтому настройка "Allow HTTP Requests" вашего опыта не затрагивается.

Разработка

npm install
npm run build          # TypeScript -> dist/
npm run build:plugin   # plugin/src -> build/StudioMCP.rbxmx
npm run install:plugin # build + copy into the Studio plugins folder
npm test               # Luau unit tests

Требуются luau, luau-compile и luau-analyze из релизов Luau в PATH или в tools/.

evals/ содержит десять вопросов, на которые можно ответить только управляя реальной сессией Studio — см. evals/README.md.

Лицензия

MIT.