Skip to main content
Glama
roblox-studio-mcp

roblox-studio-mcp

by iknouee

Roblox Studio MCP 브리지

Kiro(또는 MCP 호환 AI 어시스턴트)를 Roblox Studio에 직접 연결하세요. 자연어를 통해 스크립트를 생성, 읽기, 업데이트, 삭제하고, 인스턴스를 나열하고, Luau 코드를 실행하고, 속성을 검사할 수 있습니다.

아키텍처

┌─────────┐       stdio        ┌────────────┐      HTTP       ┌─────────────────┐
│  Kiro   │ ◄──────────────► │  MCP Server │ ◄────────────► │  Relay Server    │
│  (AI)   │                    │  (index.js) │                 │  (relay-server)  │
└─────────┘                    └────────────┘                  └────────┬────────┘
                                                                        │
                                                                   HTTP polling
                                                                        │
                                                               ┌────────▼────────┐
                                                               │  Roblox Studio   │
                                                               │  Plugin (Lua)    │
                                                               └─────────────────┘

Related MCP server: robloxstudio-mcp

빠른 시작

# 1. Clone and install
git clone https://github.com/iknouee/roblox-studio-mcp.git
cd roblox-studio-mcp
npm install

# 2. Copy plugin to Roblox Studio plugins folder
# Windows: copy plugin\KiroMCPBridge.server.lua "%LOCALAPPDATA%\Roblox\Plugins\"
# Mac:     cp plugin/KiroMCPBridge.server.lua ~/Documents/Roblox/Plugins/

# 3. Enable HTTP Requests in Studio (Game Settings → Security → Allow HTTP Requests)

# 4. Start the relay server
npm run relay

# 5. Open Roblox Studio — plugin auto-connects!

사용 가능한 도구

도구

설명

create_script

Script, LocalScript 또는 ModuleScript 생성

read_script

모든 스크립트의 소스 코드 읽기

update_script

기존 스크립트의 소스 코드 업데이트

delete_script

스크립트 인스턴스 삭제

list_instances

모든 인스턴스의 자식 나열(선택적 재귀)

execute_luau

Studio의 플러그인 컨텍스트에서 임의의 Luau 코드 실행

get_properties

모든 인스턴스의 속성 읽기

인스턴스 경로

스크립트와 인스턴스는 점 표기법을 사용하여 참조됩니다:

ServerScriptService.MyScript
ReplicatedStorage.Modules.Utils
Workspace.Map.SpawnPoints
StarterPlayer.StarterPlayerScripts.CameraController
StarterGui.MainUI.Frame.Button

문제 해결

문제

해결 방법

"Timeout waiting for Studio"

Studio가 열려 있고 릴레이 서버가 실행 중인지 확인

플러그인이 도구 모음에 없음

.lua 파일을 다시 복사하고 Studio를 재시작

"HTTP Requests are not enabled"

게임 설정 → 보안 → HTTP 요청 허용 = 켜기

npm install 실패

Node.js 18+가 설치되어 있는지 확인

포트 3001 사용 중

RELAY_PORT=3002 npm run relay

라이선스

MIT

Related MCP Connectors

Related MCP Servers