# @debuffjp/mcp 中文文档

规范地址：https://npmcn.com/package/%40debuffjp/mcp/

版本：0\.33\.0
npm 元数据更新时间：2026-11-11T02:34:37.757Z
中文译文更新时间：2026-11-11T18:50:03.094Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40debuffjp/mcp
原文对照：https://npmcn.com/package/%40debuffjp/mcp/?lang=original
项目主页：https://debuff.jp/
源码仓库：https://github.com/debuffjp/debuff

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：110 kB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：6 个
- 首次发布：2026-10-16T09:03:45.723Z
- 最新版本发布：2026-11-11T02:34:37.420Z
- 近 30 天下载量：10485（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：56（近 12 个月 56 个）

## 中文简介

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

## 安装

```sh
npm install @debuffjp/mcp
```

也可以使用：`pnpm add @debuffjp/mcp`、`yarn add @debuffjp/mcp`、`bun add @debuffjp/mcp`

## README

# @ debuffjp/ mcp

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

## 设置

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

```bash
claude mcp add debuff -- npx -y @debuffjp/mcp        # Claude Code
```

```json
{
  "mcpServers": {
    "debuff": { "command": "npx", "args": ["-y", "@debuffjp/mcp"] }
  }
}
```

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

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

```bash
/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/` (单位:千美元)[庆子](https://github.com/debuffjp/debuff/tree/main/tooling/keiko): 节点中真实的游戏, 无浏览器; 失败带有勾选, 场景和状态 |
| `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_input` | `press` 编号 : `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](https://papercuts.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 是什么？

解禁的 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 和提交记录判断。