Tripwire

由 alibolly 制作

一个 MCP 服务器，让 AI 编码代理真正控制 Roblox Studio 和 Roblox Open Cloud， 并带有其他 Studio MCP 所没有的测试与安全层。

Tripwire 让助手能够读取、写入和编辑数据模型，通过模拟输入驱动试玩， 在真实引擎中无头运行测试即代码，标记游戏代码中的客户端信任漏洞， 并调用 Open Cloud API（DataStores、MessagingService、Memory Stores 等）。Studio 工具 无需 API 密钥；无头测试、资产和 Open Cloud 工具使用 Open Cloud 密钥。

要求

• 一个 MCP 客户端：Claude Code、Codex、Gemini，或任何通过 stdio 支持 MCP 的客户端。

• Roblox Studio，用于 Studio 工具。这些不需要 API 密钥。

• Node.js，仅当您使用 npx 运行服务器时需要。预构建二进制文件不需要 Node。

• 对于无头测试、资产和 Open Cloud 工具：需要一个已发布的 place 和 Roblox Open Cloud API 密钥。参见 Open Cloud 设置。

Related MCP server: Roblox Studio Ultimate MCP Server

快速开始

Tripwire 适用于通过 AI 编码代理驱动 Studio 的 Roblox 开发者。

1. 将服务器接入您的 MCP 客户端（一条命令或一个小配置块，参见下面的 安装）。

2. 安装 Studio 插件，以便 Studio 工具能够访问 Studio（参见安装中的插件步骤）。

3. 在 Studio 中打开您的 place，启用 游戏设置 > 安全 > 允许 HTTP 请求，然后点击 Tripwire 工具栏按钮并在面板中按 连接。面板显示已连接，输出打印 [Tripwire v...] connected。

4. 让您的代理运行 studio_status。已连接的 Studio 确认桥接正常工作。

5. 可选：为无头测试、资产和 Open Cloud 工具添加 Open Cloud 密钥（参见 Open Cloud 设置）。

安装

Tripwire 的服务器是一个单一二进制文件。最简单的运行方式是使用 npx，它会为您的平台获取 预构建二进制文件，因此无需安装 Rust 工具链。更喜欢手动二进制文件 或从源码构建？请参阅本节末尾的替代方案。

一条命令：

claude mcp add --transport stdio tripwire -- npx -y tripwire-roblox

或者将其添加到项目的 .mcp.json（或 ~/.claude.json）中：

{
  "mcpServers": {
    "tripwire": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tripwire-roblox"]
    }
  }
}

添加到 ~/.codex/config.toml：

[mcp_servers.tripwire]
command = "npx"
args = ["-y", "tripwire-roblox"]

或者：codex mcp add tripwire -- npx -y tripwire-roblox

添加到 ~/.gemini/settings.json（或项目的 .gemini/settings.json）：

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

或者：gemini mcp add tripwire npx -y tripwire-roblox

任何通过 stdio 支持 MCP 的客户端都可以运行它：

command: npx
args:    ["-y", "tripwire-roblox"]

预构建二进制文件（无需 Node）。 从 Releases 页面下载适用于您平台的压缩包（例如 tripwire-server-vX.Y.Z-aarch64-apple-darwin.tar.gz），解压，并将客户端的 command 指向解压后的 tripwire-server，args 为空。

从源码构建（需要 Rust）：

git clone https://github.com/aliboIly/Tripwire.git
cd Tripwire/server
cargo build --release   # produces server/target/release/tripwire-server

然后将客户端的 command 指向该二进制文件路径。

Studio 工具通过一个小插件访问 Studio，该插件长轮询本地服务器。从 Releases 页面获取 Tripwire.rbxmx，或自行构建：

cd Tripwire/plugin
npm install
npx rbxtsc
rojo build --output Tripwire.rbxmx
cp Tripwire.rbxmx ~/Documents/Roblox/Plugins/   # macOS; Windows: %LOCALAPPDATA%\Roblox\Plugins

重启 Studio，启用 游戏设置 > 安全 > 允许 HTTP 请求，然后点击 Tripwire 工具栏按钮并在面板中按 连接。面板显示已连接， 输出打印 [Tripwire v...] connected。

Studio 工具不需要密钥。Open Cloud 工具需要。参见下面的 Open Cloud 设置 获取完整指南。

Open Cloud 设置

Tripwire 的大部分功能不需要凭据。以下工具需要，因为它们调用 Roblox Open Cloud： run_luau、无头测试（run_tests、run_test_file、list_tests），以及下面 Open Cloud 部分中的每个工具（资产、发布、数据存储、消息传递、内存、universe 和 服务器、Engine Instance API、审核、密钥、变现、Creator Store、群组、 分析、平台和 open_cloud_request）。它们使用 Roblox Open Cloud API 密钥进行身份验证。

使用风险自负。 Open Cloud 密钥是真实的凭据，对您的体验拥有真正的控制权。 根据您授予的范围，它可以读取和覆盖您的实时 DataStores、 发布您 place 的新版本、将资产上传到您的账户，并向您的服务器发送消息。请像对待 密码一样对待它：只授予您实际使用的范围，限制为您的 IP， 切勿提交，如果泄露则撤销。您对自己使用它的行为负责。Tripwire 与 Roblox 无关联，也未获得 Roblox 的认可。

1. 创建密钥

1. 前往 create.roblox.com/dashboard/credentials 并登录。

2. 点击 创建 API 密钥 并命名（例如 Tripwire）。

3. 在 访问权限 下，仅添加您所需工具对应的 API 系统，并为每个系统授予其所需的操作，范围限定为您的体验。仪表板提供的每个系统都有对应的工具；映射关系见下面的 权限到工具。简要说明：

   • Luau 执行（写入）：run_luau 和无头测试。

   • universe-places（写入）：publish_place。

   • 资产（读取 + 写入）和 资产权限：资产工具。

   • DataStores 和 有序 DataStores：数据存储工具。

   • 消息传递服务（发布）和 内存存储：这些工具。

   • Universe、Place、Instance、用户限制、密钥、分析：universe、服务器、实例、审核、密钥和分析工具。

   • 开发者产品、游戏通行证、Creator Store：变现和商店工具。

   • 用户/群组/库存/订阅/通知：平台、群组和互动工具。

   • 其他任何内容（旧版和实验性系统）：open_cloud_request。

4. 在 安全 下，将 接受的 IP 地址 设置为您机器的 IP，或 0.0.0.0/0 以允许任何 IP（本地使用最简单）。如果需要，可以设置过期时间。

5. 点击 保存并生成密钥 并复制密钥字符串。它只显示一次。

2. 查找您的 universe 和 place ID

在 Studio 命令栏（视图，然后命令栏）中运行：

print("universe", game.GameId, "place", game.PlaceId)

GameId 是您的 ROBLOX_UNIVERSE_ID；PlaceId 是您的 ROBLOX_PLACE_ID。place 必须 已发布 到 Roblox，Open Cloud 才能对其操作。

3. 将凭据提供给 Tripwire

在仓库根目录创建 .env。它已被 gitignore，服务器会自动加载它：

ROBLOX_OPEN_CLOUD_KEY=paste_the_key_here
ROBLOX_UNIVERSE_ID=000000
ROBLOX_PLACE_ID=000000
ROBLOX_CREATOR_USER_ID=000000   # only for upload_asset (your user id)

或者将相同的变量放入 MCP 客户端的 env 块中（这些优先）。 更改任一后重新连接 MCP 服务器。每个工具在密钥授予其范围时正常工作， 如果缺少范围则返回 Roblox 自己的错误，因此您可以随时添加范围。

工具

连接

读取和检查

空间（只读）

编辑（每个都是一步撤销）

试玩和输入

测试与无头执行（Open Cloud）

安全审查（静态分析，无需密钥）

资产与发布（Open Cloud）

数据存储（Open Cloud）

消息与内存（Open Cloud）

宇宙、地点与服务器（Open Cloud）

引擎实例 API（Open Cloud，无需 Studio）

审核（Open Cloud）

机密（Open Cloud）

变现与 Creator Store（Open Cloud）

群组（Open Cloud）

平台、互动与分析（Open Cloud）

其他所有内容（Open Cloud）

工具权限

每个可添加到 Creator Dashboard 密钥上的 API 系统，以及使用它的工具。范围名称是仪表盘和 Roblox 错误消息所使用的名称。

你可以做什么

• 根据提示构建场景。 创建和批量创建实例、设置类型化属性、插入模型、编写脚本，每一步 都是一个干净的撤销步骤。

• 在 CI 中测试游戏玩法。 编写 spec，通过 Open Cloud 在真实引擎中无头运行它们，并 以结果作为拉取请求的门禁。

• 在上线前捕获漏洞。 安全审查器会标记出信任客户端输入的服务器处理器，并给出服务端 修复建议；每个 PR 都会自动运行同样的检查。

• 驱动一次真实的试玩测试。 进入 Play 模式，发送键盘和鼠标输入，让角色走到某个位置， 读取服务器/客户端合并输出，然后停止。

• 检查实时 place。 读取实例树，按名称或属性搜索，读取并 grep 脚本，拉取 Output 日志。

• 自动化 Open Cloud。 为测试夹具填充 DataStores，发布 place，广播 MessagingService 主题，或查找用户、群组和库存。

已知限制

这些是平台限制，不是缺陷。把它们写在这里，是为了让你一开始就心里有数。

• F5 试玩测试的停止是尽力而为的。stop_playtest 可能不生效，因为插件和运行中的游戏是 相互独立的 DataModels。stop_simulation（F8）可以干净地停止。如果 F5 试玩测试无法 停止，请在 Studio 中按 Stop。

• 游戏内操作通过注入的 runner 进行。试玩测试期间的输入、运行时状态和停止都通过桥接中继， 而不是直接在插件上调用。

• 无头测试在服务器上下文中运行。Open Cloud 会在服务器上运行你已发布的 place，在那里 RunService:IsStudio() 为 false，且不存在插件 API。请将其用于服务器和游戏逻辑以及 安全测试，而不是用于 Studio 插件或客户端输入行为。

• 与 Roblox 内置 Assistant 的工具一致性是手工维护的。

• 有几个 Open Cloud 系统在 Roblox 那边仍处于 beta 或试验阶段（Instance API、用户限制、 secrets、游戏服务器、analytics，以及 open_cloud_request 背后的所有内容）。它们的 形态可能会变化，而且 open_cloud_request 返回的是原始响应，而不是整理好的。

Tripwire 由一个人在业余时间维护。Issue 和拉取请求通常在一周左右内得到回复。回复慢并不 代表拒绝。

故障排除

Studio 工具超时，或报告没有已连接的 Studio。 插件未连接。安装 Tripwire.rbxmx， 重启 Studio，点击 Tripwire 工具栏按钮，然后在面板中按 Connect。面板状态和 Output 中的 [Tripwire v...] connected 一行都能确认已连接。

插件报告 HTTP 被阻止。 在当前打开的 place 上，打开 Game Settings > Security > Allow HTTP Requests。这是最常见的设置失败原因。没有它，Studio 就无法访问本地桥接。

Output 显示插件与服务器之间存在版本不匹配。 已安装的 .rbxmx 已过期。重新构建它 （npx rbxtsc && rojo build --output Tripwire.rbxmx），复制到你的 Plugins 文件夹，然后 重启 Studio。插件会打印其编译版本，所以前缀会告诉你实际安装的是哪个版本；面板标题显示 相同的版本。

某个 Open Cloud 工具返回 401 Invalid API Key。 密钥本身未被接受：它被重新生成过、 已过期，或者粘贴不完整。所有工具都会以同样的方式失败。请在 Creator Dashboard 上重新创建 或复制密钥，替换 ROBLOX_OPEN_CLOUD_KEY，然后重新连接 MCP 服务器。

某个 Open Cloud 工具返回 403 或 scope 错误。 密钥缺少该工具所需的 scope，universe 或 place id 不对，或者 place 尚未发布。请在 Creator Dashboard 上添加该 scope（工具描述 中指出了它），确认相关 id，然后重新连接 MCP 服务器。错误文本是 Roblox 自己的，所以它会 明确指出缺少什么。

run_tests 看不到你的最新更改。 它读取的是已发布的 place。请先发布；rojo serve 只更新实时编辑会话，而不是 Open Cloud 所运行的内容。

npx 无法获取服务器。 你没有安装 Node.js，或者首次下载时没有网络。请安装 Node， 或者使用 Releases 页面上的预构建二进制文件，并将 command 指向它（参见 Install 下的 Alternatives）。

服务器提示桥接端口被占用。 之前的某个服务器仍占用着端口 44331。请关闭旧的 MCP 会话 或过期的进程，然后重新连接。

先前工作

Studio 运行时方案（一个长轮询本地服务器的插件、一个注入的游戏内 runner）借鉴了 boshyxd/robloxstudio-mcp 和 Chrrxs/robloxstudio-mcp 的思路。Tripwire 是一个独立的、从零开始的实现；无头测试框架、CI 安全审查器和 Open Cloud 工具都是它自己的。

贡献指南

欢迎提交缺陷报告、功能想法和补丁。设置、构建门禁以及分支和提交规则请参阅 CONTRIBUTING.md；各部分如何组合在一起请参阅 ARCHITECTURE.md。参与即表示你同意 行为准则。

发现安全漏洞？请不要公开提交 issue。私有披露途径请参阅 SECURITY.md。

更新日志

每个版本的发布说明见 Releases 页面。

许可证

MIT。参见 LICENSE。