@debuffjp/mcp

中文文档
0.33.0发布于 2026/11/11MITTypeScriptES Module构建来源已验证近 30 天下载 1万

解禁的 MCP 服务器: 让 AI 代理检查, 构建, 测试和玩解禁游戏

中文使用文档
文档目录4 节
  1. 设置
  2. 工具
  3. 提示
  4. 无头活活

@ debuffjp/ mcp

一个 MCP 磁共振 服务器,允许AI代理检查、构建、测试和 播放 一个解禁游戏。 它使用了人类想要的相同证据:真实状态,真实框架,真实测试结果.

设置

新项目 npm create debuff 列入a .mcp.json,所以读取它的MCP客户端(如克洛德代码)自动取取服务器. 对于其他客户:

claude mcp add debuff -- npx -y @debuffjp/mcp        # Claude Code
{
  "mcpServers": {
    "debuff": { "command": "npx", "args": ["-y", "@debuffjp/mcp"] }
  }
}

从游戏文件夹中运行, 或者通过 --root <dir> (或设置) DEBUFF_ROOT) (中文(简体) ).

作为克洛德代码插件,它也增加了一种技能来教导克洛德工作流程:

/plugin marketplace add debuffjp/debuff
/plugin install debuff@debuff

作为编码插件 : codex plugin marketplace add debuffjp/debuff,则 codex plugin add debuff@debuff。 。 。 .

对于克洛德桌面, mcpb/manifest.json 描述一个询问游戏文件夹的桌面扩展名。 把它从文件夹中包装 npx @anthropic-ai/mcpb pack。 。 。 .

工具

工具它会做什么
inspect_project依赖性、插件及其贡献、资产、最后一个构建大小
list_assets每一个资产及其类型、大小和进口商,加上警告和可能未使用的识别码
typecheck与项目本身进行类型核对 tsc;不需要浏览器。 Vite 不进行键入检查, 在编辑后运行
build生产建设加规模报告; leaks 必须是空的
run_tests运行逻辑测试 tests/ (单位:千美元)庆子: 节点中真实的游戏, 无浏览器; 失败带有勾选, 场景和状态
run_scenarios运行 scenarios/*.json 无头;每步结果、出错、抓取
fuzz用随机输入播放; 每一个崩溃, 被卡住的状态或回放和forth循环都会出现一个解释错误和重放它的情况
game_start附在活游戏上,或打开私人无头副本,暂停(见下文). 无头取一 viewport: [w, h]· ; reducedMotion 强迫它打开或关闭
game_step提前的固定模拟步骤( 暂停先); 返回状态( E)quiet 离开你的 inspect() 数据)
game_pause暂停或恢复直播游戏
game_frames最近的帧分解:更新/交出 ms, 追赶步骤, 四分位, 绘图调用, 长任务 ; summary 给百分位数和三个最慢的
game_notes上面标有人类标志的瞬间, 状态在那一滴
game_rewind活模式:将人类的游戏带回(或前行)到一个勾点,暂停,然后其确切状态
game_replay将现场会话保存到一个勾选(例如注释),作为在 .debuff/replays/ 复制它。 从0.31起,它设有国家检查站,所以 run_scenarios 在重播停止匹配的勾选时警告
game_inputpress 编号 : release 键(和 PointerRight 编号 : PointerMiddle(三); tap, (中文(简体) ), pointer_down (带有可选内容) kind:鼠标、触摸或笔, pointer_move, (中文(简体) ), pointer_up· ; wheel (单位:千美元)dy, (中文(简体) ), dx(三); touch_down, (中文(简体) ), touch_move, (中文(简体) ), touch_up 通过联系 id
game_state场景,勾选,逻辑宽度/高度,渲染器,帧统计, reducedMotion、 inspect() 数据
game_command运行注册游戏的命令 devTools({ commands }),带有 JSON 参数
game_params 编号 : game_set_param读取并调取已键入参数( 已验证)
game_capture目前的框架为PNG图像; path 也保存在项目中(hum,商店艺术). social: true x和Bluesky职位的字母框为1200x675(增加于0.26)
game_clip直播模式 : start 一个滚动录音, save 最后15秒作为录像 .debuff/captures/, (中文(简体) ), stop用于编剧和新闻资料袋;人员职位。 增加为0.26
game_errors运行时错误, 解释: 谁的问题( 您的代码, 拒绝的呼叫, 解禁错误) , 源行, 提示
game_stop关上游戏. 从0.28开始,一个无头游戏在15分钟闲置后也关闭,一个需要超过60s的电话失败了 game_hung
report_papercut报告用工具摩擦去布克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 剪纸.debuff.jp返回近距离匹配,而不是重复提交;再次调用 hit: <id> 或者说 force: true与 hit, (中文(简体) ), workaround 当纸张切割没有(从0.24.1)时,则填补它的工作。 增加为0.24

工具调用在一周内两次失败,或运行太长,被报告给papercuts.debuff.jp自己,结果如此(见 debuff papercuts 在CLI读取关闭。 从0.24.

提示

工作流程客户端可以作为斜线命令提供: playtest, (中文(简体) ), fix-errors, (中文(简体) ), tune-feel, (中文(简体) ), add-mechanic, (中文(简体) ), devlog-post (在0.26中添加:抓取一个静物和一个剪辑,然后起草供人类发送的短文)和 explain-stutter。 。 。 .

无头活活

如果游戏在下面打开 debuff dev, (中文(简体) ), game_start 附 录 那个标签 (模式) live) (中文(简体) ). 覆盖显示 代理人 徽章,并且每个暂停、步骤和参数改变代理商的行为都出现在其活动日志中,在那里可以撤消它。 键入覆盖符中的注 (“ 跳跃感觉漂浮在这里 ” ) 以标出一瞬间; 代理读取该注解, 以及该勾选的游戏状态 game_notes。 。 。 . game_stop 恢复您的游戏和断开.

否则,或与 mode: "headless",代理在无头浏览器中获得私人副本. 时间只通过 game_step,所以它所看到的是可复制的,一个情景可以完全重放.

版本与发布记录

@debuffjp/mcp 共发布 56 个版本,首次发布于 2026/10/16;过去 12 个月发布了 56 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.33.0latest2026/11/11今天
0.32.02026/11/074 天前
0.31.12026/11/065 天前
0.31.02026/11/065 天前
0.30.02026/11/056 天前
0.29.22026/11/056 天前

关于 @debuffjp/mcp 的常见问题

@debuffjp/mcp 是什么?

解禁的 MCP 服务器: 让 AI 代理检查, 构建, 测试和玩解禁游戏

如何安装 @debuffjp/mcp?

在项目目录运行 npm install @debuffjp/mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 debuff-mcp,可以用 npx debuff-mcp 直接运行。

@debuffjp/mcp 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@debuffjp/mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@debuffjp/mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@debuffjp/mcp 可以商用吗?

@debuffjp/mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@debuffjp/mcp 的下载量有多少?

根据 npm 官方下载统计,@debuffjp/mcp 在 2026/10/12 – 2026/11/10 这 30 天内被下载 10,485 次,日均约 350 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@debuffjp/mcp 还在维护吗?

最新版本 0.33.0 发布于 2026/11/11(今天);至今共发布 56 个版本,其中过去 12 个月发布了 56 个;首次发布于 2026/10/16。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。