AI导哈

Roblox属性检查工具

一个用于检查Roblox Studio属性、路径和对象的只读MCP服务器，专注于游戏对象层级导航、属性检查和搜索功能。

  • by boshyxd
  • Luau
  • 本地部署
  • 更新于
在 GitHub 查看 boshyxd/roblox-inspector-mcp

使用说明

Roblox检查员MCP

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

目的

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

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

确实如此 非 提供：

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

可用工具（共15个）

层次结构和导航

工具 说明
get_file_tree 使用模型、文件夹和UI元素获取完整的项目层次结构
get_project_structure 获得具有可配置深度的游戏层次结构（使用5-10进行彻底探索）
get_instance_children 获取用于导航的子对象及其类型

搜索工具

工具 说明
search_files 按名称或类型模式查找实例
search_objects 按名称、类或属性查找实例
search_by_property 查找具有特定属性值的对象

财产清查

工具 说明
get_instance_properties 获取特定实例的所有属性
mass_get_property 同时从多个实例中获取相同的属性

属性检验

工具 说明
get_attribute 从实例中获取单个属性值
get_attributes 获取实例上的所有属性

标签检查

工具 说明
get_tags 获取实例上的所有标签
get_tagged 获取具有特定标记的所有实例

工作室背景

工具 说明
get_place_info 获取地点ID、名称和游戏设置
get_services 获取Roblox服务及其子女
get_class_info 获取Roblox类的可用属性/方法

安装

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插件。检查器版本只是公开了一个较小的只读工具子集。

环境变量

变量 默认值 描述
ROBLOX_STUDIO_PORT 3002 HTTP网桥端口
ROBLOX_STUDIO_HOST 0.0.0.0 HTTP网桥主机

兼容性

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

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

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

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

使用 robloxstudio mcp 什么时候：

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

许可证

麻省理工学院

相关 MCP