Skip to main content
Glama
deenesjakoruzh
iknouee

roblox-studio-mcp

by iknouee
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Local

Roblox Studio MCP Bridge

Подключите Kiro (или любого MCP-совместимого ИИ-ассистента) напрямую к 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

Выполнить произвольный код Luau в контексте плагина Studio

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

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers