Skip to main content
Glama
roblox-studio-mcp

roblox-studio-mcp

by iknouee

Roblox Studio MCP Bridge

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!

利用可能なツール

Tool

Description

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

トラブルシューティング

Problem

Fix

"Timeout waiting for Studio"

Studioが開いていることと、リレーサーバーが実行中であることを確認

Plugin not in toolbar

.luaファイルをコピーし直してStudioを再起動

"HTTP Requests are not enabled"

Game Settings → Security → Allow HTTP Requests = ON

npm install fails

Node.js 18+がインストールされていることを確認

Port 3001 in use

RELAY_PORT=3002 npm run relay

ライセンス

MIT

Related MCP Connectors

Related MCP Servers