Roblox Studio MCP

Roblox Studio용 MCP 서버입니다. 푸시 기반 브리지를 통해 29개의 도구를 제공하며, 모든 쓰기 작업은 한 번에 일괄 처리되고 한 번의 실행 취소로 되돌릴 수 있습니다. MIT 라이선스.

설치

1. Studio 플러그인

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

또는 Releases에서 StudioMCP.rbxmx를 다운로드하여 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를 켠 후 Studio를 다시 시작하세요. 이 기능 없이도 다른 모든 것은 작동하지만, ScriptDebuggerService가 이 기능을 활성화해야만 등록되므로 중단점은 작동하지 않습니다.

포트 기본값은 44755입니다 — --port 또는 ROBLOX_STUDIO_MCP_PORT로 설정하며, 플러그인 위젯에서도 확인할 수 있습니다. 루프백 전용입니다.

여러 에이전트를 동시에 사용할 수 있습니다. 원하는 만큼 많은 클라이언트에 이 서버를 등록하세요 — Claude 세션 두 개, Claude와 Cursor 조합, 무엇이든 가능합니다. 플러그인은 하나의 포트로 연결되므로, 가장 먼저 시작된 서버가 그 포트를 소유하고 나머지는 자동으로 프록시됩니다. 설정할 것도 없고, Studio에 대한 두 번째 연결도 필요 없습니다.

각 에이전트는 자체 대상을 유지합니다: set_active_studio는 클라이언트별로 바인딩되므로, 두 에이전트가 동시에 두 개의 열린 장소에서 작업할 수 있고 서로의 대상을 바꿀 수 없습니다. 단일 호출에서 다른 곳에 도달하려면 studioId를 전달하세요. 기본값을 유지하므로 열린 Studio가 하나뿐이면 id가 전혀 필요 없습니다.

격리는 MCP 연결별로 이루어지며, 하위 에이전트는 상위 에이전트의 대상을 공유합니다 — 측정된 동작이지 가정이 아닙니다. 하위 에이전트가 set_active_studio를 호출하면 상위 에이전트와 다른 하위 에이전트들의 대상이 조용히 바뀌며, 이후 호출은 여전히 성공하지만 대상이 다른 곳을 가리키게 됩니다. 하위 에이전트에는 호출마다 명시적인 studioId를 전달하세요. 연결 상에서 하위 에이전트와 상위 에이전트를 구분할 수 있는 방법은 없으므로, 이는 서버가 강제할 수 없는 사항이 아니라 지침입니다.

Related MCP server: Roblox Studio MCP

도구

주의 사항: debug는 파일 → 베타 기능에서 API debugger Luau가 필요합니다. device 에뮬레이션은 device op="stop"까지 지속됩니다. 플레이테스트 중에는 두 개의 세션이 연결되므로 — 유지되어야 하는 모든 것에는 studioId를 명시적으로 전달하고 편집 세션을 사용하세요.

일괄 처리

모든 쓰기 도구는 배열을 받습니다. 스크립트 10개 편집, 인스턴스 200개 삭제, 맵 전체 앵커링은 한 번의 호출로 처리됩니다 — 반복문이 아닙니다.

modify의 상한은 항목 수에 적용되며 대상 수가 아닙니다 — 하나의 항목이 인스턴스 500개를 앵커링할 수 있으므로, find와 함께 사용하면 단일 호출로 전체 장소를 변경할 수 있습니다.

속도 외에 얻을 수 있는 이점:

• Ctrl+Z 한 번. 일괄 처리는 도구 이름으로 기록되는 단일 ChangeHistoryService 레코드 안에서 실행됩니다. 스크립트 편집 10개가 한 단계로 실행 취소됩니다 — 10단계가 아닙니다.

• 전부 아니면 전무. 모든 읽기와 변환은 메모리에서 먼저 수행된 후에야 쓰기가 진행되므로, 일치하는 항목이 없거나 두 번 일치하는 find는 장소가 절반만 수정된 채 남는 대신 아무것도 변경되지 않은 채 실패합니다.

• 중첩. create는 children을 받으므로 모델 전체가 한 번의 호출로 생성됩니다. 새 인스턴스의 경로는 생성되기 전까지 알 수 없으며, 같은 이름의 형제 인스턴스가 있으면 경로 추측이 불가능합니다.

병렬 호출도 가능합니다 — 응답은 요청 ID로 키가 지정되므로 한 턴에서 여러 호출을 동시에 실행할 수 있습니다. 일괄 처리가 가능한 경우 일괄 처리를 우선 사용하세요: 병렬 호출은 N회의 왕복과 N단계의 실행 취소가 필요하지만, 일괄 처리는 각각 한 번으로 끝납니다.

다른 도구와 비교

• 폴링이 아닌 푸시. 500ms 폴링 대신 SSE 스트림을 사용합니다. 순차 왕복 50회: 평균 13.6ms 대 25.8ms, 중앙값 12.8ms 대 29.9ms. node scripts/latency.mjs --count 50 --compare로 재현할 수 있습니다.

• 안전한 스크립트 편집. script.Source가 아닌 ScriptEditorService:UpdateSourceAsync를 사용하므로 — 저장하지 않은 편집기 버퍼가 유지됩니다.

• 작업당 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 리바인딩 취약점을 차단합니다. Studio는 플러그인별, URL별로 HTTP 권한을 부여하므로 경험의 "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, luau-compile, luau-analyze가 PATH 또는 tools/에 필요합니다.

evals/에는 실제 Studio 세션을 구동해야만 답할 수 있는 질문 10개가 있습니다 — evals/README.md를 참조하세요.

라이선스

MIT.