Roblox Inspector MCP

Roblox检查员MCP

A. 只读的 MCP（模型上下文协议）服务器，用于检查Roblox Studio属性、路径和对象。这是一种轻量级的替代方案 robloxstudio mcp 它只专注于检查，没有任何脚本或修改功能。

目的

此MCP服务器专为需要AI的工作流程而设计，以便：

• 获取实例属性 （位置、大小、颜色、透明度等）
• 浏览游戏层次结构 （查找对象的路径）
• 搜索对象 按名称、类或属性值
• 检查UI元素、模型和硬编码值
• 读取属性和标签

确实如此 非 提供：

• 脚本阅读或编辑
• 改性
• 对象创建/删除
• 任何写入操作

可用工具（共15个）

层次结构和导航

搜索工具

财产清查

属性检验

标签检查

工作室背景

安装

1.安装MCP服务器

npm install -g roblox-inspector-mcp

或者直接在MCP配置中使用npx。

2.安装Studio插件

复制 studio-plugin/MCPPlugin.rbxmx 到您的Roblox Studio插件文件夹：

• 窗户： %LOCALAPPDATA%\Roblox\Plugins\
• 雨衣： ~/Documents/Roblox/Plugins/

或者从源代码安装：

1. 打开Roblox工作室
2. 转到“查看”>“资源管理器”
3. 右键单击 ServerStorage 或任何地点
4. 选择“从文件插入”，然后选择 MCPPlugin.rbxmx
5. 移动到 ServerStorage 或作为插件运行

3.配置您的MCP客户端

添加到您的Claude Desktop或其他MCP客户端配置中：

{
  "mcpServers": {
    "roblox-inspector": {
      "command": "npx",
      "args": ["-y", "roblox-inspector-mcp"]
    }
  }
}

或者，如果全局安装：

{
  "mcpServers": {
    "roblox-inspector": {
      "command": "roblox-inspector-mcp"
    }
  }
}

使用示例

获取零件的所有属性

Use get_instance_properties with path "game.Workspace.MyPart"

查找游戏中的所有文本标签

Use search_objects with query "TextLabel" and searchType "class"

获取多个零件的位置

Use mass_get_property with paths ["game.Workspace.Part1", "game.Workspace.Part2"] and propertyName "Position"

查找具有特定标记的所有对象

Use get_tagged with tagName "Interactable"

探索游戏层次结构

Use get_project_structure with maxDepth 8 for comprehensive exploration

建筑

AI Tool Call → MCP Server (Node.js) → HTTP Bridge → Roblox Studio Plugin → Roblox API

服务器使用与robloxstudio mcp相同的网桥架构，因此两者可以共享相同的Studio插件。检查器版本只是公开了一个较小的只读工具子集。

环境变量

兼容性

• 使用与相同的Studio插件 robloxstudio mcp
• 两台服务器可以共存（只需在不同的端口上运行它们）
• 需要Node.js 18+

为什么使用这个而不是robloxstudio mcp？

使用 roblox检查员mcp 什么时候：

• 您只需要读取/检查属性
• 您想防止意外修改
• 您正在构建一个不应该具有写访问权限的工作流
• 你想要一个更小的AI工具表面

使用 robloxstudio mcp 什么时候：

• 您需要修改脚本
• 您需要创建/删除对象
• 您需要完全的读写权限

许可证

麻省理工学院