一个高级的模型背景协议(MCP)服务器,允许AI代理与运行的Roblox游戏客户端互动. 这个服务器可以实现代码执行,脚本解编,实例分级查询,远程事件间谍和射击,以及实时日志流.

– – . . .

# # 关键特性

代码执行 — 动态运行客户端的Luau代码,可选返回值产生. *** 脚本检查* — 解编脚本,跨源搜索,并进行语义搜索. *** Instance Search & Manipulation** — 使用类似 CSS 的选取器,穿行实例等级树,并查询动态属性/属性.

• Remote Spy & Fire——拦截,日志,块,被忽略,并起火[[T0]/[[T1] (由Cobalt作后盾).
• ** Real-Time Log Streaming** — 捕捉客户端控制台通过WebSockets动态输出并现场观看.
• **GUI Interactive ** — 通过点击按钮和将文本输入UI元素来自动输入.
• OS集成——检索Roblox进程列表并抓取客户端窗口截图(仅Windows).
• ** 多轨运行** — 多个运行客户之间的协调,自动进行初级/二级升级和接力.

Roblox Executor MCP Server

An advanced Model Context Protocol (MCP) server that allows AI agents to interact with running Roblox game clients. This server enables code execution, script decompilation, instance hierarchy querying, remote event spying and firing, and real-time log streaming.

---

🚀 Key Features

• Code Execution — Run Luau code on the client dynamically, with optional return value yielding.
• Script Inspection — Decompile scripts, search across sources, and perform semantic searches.
• Instance Search & Manipulation — Use CSS-like selectors, traverse the instance hierarchy tree, and query dynamic properties/attributes.
• Remote Spy & Fire — Intercept, log, block, ignore, and fire RemoteEvents / RemoteFunctions (backed by Cobalt).
• Real-Time Log Streaming — Capture client console outputs dynamically via WebSockets and view them live.
• GUI Interaction — Automate input by clicking buttons and typing text into UI elements.
• OS Integrations — Retrieve list of Roblox processes and capture client window screenshots (Windows only).
• Multi-Client Routing — Coordinate between multiple running clients with automatic Primary/Secondary promotion and relaying.
• Local Script Hub — Save, load, and execute pre-configured Luau scripts.

---

🖥️ Local Web Dashboard

The Roblox Executor MCP includes a rich, responsive local web dashboard hosted at:

http://localhost:16384/

Use the dashboard to monitor connected clients, debug executables, and inspect games:

1. Console Tab (New): A real-time stream of the Roblox client console logs (LogService.MessageOut), color-coded by log levels: Info (White), Warning (Yellow), and Error (Red).
2. Executor Tab (New): A developer-focused suite to write Luau code directly, toggle “Get Return Value” to yield and print results, and instantly execute scripts saved in the user-scripts/ hub.
3. Tools Tab: A control center to run all registered MCP tools manually and review inputs/outputs.
4. Scripts Tab: Explore local and decompiled scripts, search sources, index game hierarchies, and set up semantic vector search.

---

🛠️ Complete Tool Catalog

The server registers a comprehensive list of tools for connected AI agents:

1. Client Management

• list-clients — Lists all currently connected Roblox game clients.
• set-active-client — Selects the active target client for subsequent tool operations.

2. Execution Tools

• execute — Executes raw Luau code on the active Roblox client.
• execute-file — Executes a Luau file from the server’s local path.
• teleport-player (New) — Relocates the player to specific coordinates, offsets, or target players.