Skip to main content
Glama
Sign In
deenesjakoruzh
roblox-studio-mcp

roblox-studio-mcp

by iknouee
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

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!

可用工具

工具

描述

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

故障排除

问题

修复

等待 Studio 超时

确保 Studio 已打开且中继服务器正在运行

插件不在工具栏中

重新复制 .lua 文件并重启 Studio

未启用 HTTP 请求

游戏设置 → 安全 → 允许 HTTP 请求 = 开启

npm install 失败

确保已安装 Node.js 18+

端口 3001 被占用

RELAY_PORT=3002 npm run relay

许可证

MIT

This server cannot be deployed

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Maintenance

ActivityStale
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers