debuff

jp.debuff由 debuff.jp 发布v0.32.0更新于 Nov 7, 2026

让编码智能体试玩、测试并调优你的2D网页游戏：实时状态、错误解释、回放、模糊测试。

AI 翻译由 AI 模型根据下方的原文描述翻译，可能有误。

原文描述

Let coding agents play, test and tune your 2D web game: live state, explained errors, replays, fuzz.

已验证STDIO仅桌面浏览器自动化开发者工具媒体与设计

概览

debuff 的本地 MCP 服务，由 debuff.jp 发布；无需登录；STDIO。

暂无 AI 概览：以下信息来自注册中心条目和服务本身。

发布者
debuff.jp

安装

在 SourceWeft 中

  1. 打开 控制台中的 debuff，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@debuffjp/mcp

An MCP server that lets AI agents inspect, build, test and play a debuff game. It uses the same evidence a human would want: real state, real frames, real test results.

Setup

New projects from npm create debuff include a .mcp.json, so MCP clients that read it (such as Claude Code) pick the server up automatically. For other clients:

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

Run it from the game's folder, or pass --root <dir> (or set DEBUFF_ROOT).

As a Claude Code plugin, which also adds a skill that teaches Claude the workflow:

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

As a Codex plugin: codex plugin marketplace add debuffjp/debuff, then codex plugin add debuff@debuff.

For Claude Desktop, mcpb/manifest.json describes a desktop extension that asks for the game folder. Pack it from that folder with npx @anthropic-ai/mcpb pack.

Tools

ToolWhat it does
inspect_projectDependencies, plugins and their contributions, assets, last build size
list_assetsEvery asset with its type, size and importer, plus warnings and possibly unused ids
typecheckType-check with the project's own tsc; no browser needed. Vite doesn't type-check, so run it after edits
buildProduction build plus size report; leaks must be empty
run_testsRun the logic tests in tests/ (keiko): the real game in Node, no browser; failures carry the tick, scene and state
run_scenariosRun scenarios/*.json headless; per-step results, errors, captures
fuzzPlay with random input; each crash, stuck state or back-and-forth loop comes with an explained error and a scenario that replays it
game_startAttach to the live game, or open a private headless copy, paused (see below). Headless takes a viewport: [w, h]; reducedMotion forces it on or off
game_stepAdvance fixed simulation steps (pausing first); returns state (quiet leaves out your inspect() data)
game_pausePause or resume a live game
game_framesRecent frame breakdown: update/render ms, catch-up steps, quads, draw calls, long tasks; summary gives percentiles and the 3 slowest
game_notesMoments the human flagged in the overlay, with the state at that tick
game_rewindLive mode: take the human's game back (or forward) to a tick, paused, with its exact state then
game_replaySave the live session up to a tick (for example a note's) as a scenario in .debuff/replays/ that reproduces it. From 0.31 it holds state checkpoints, so run_scenarios warns at the tick where the replay stops matching
game_inputpress / release keys (and PointerRight / PointerMiddle); tap, pointer_down (with an optional kind: mouse, touch or pen), pointer_move, pointer_up; wheel (dy, dx); touch_down, touch_move, touch_up by contact id
game_stateScene, tick, logical width/height, renderer, frame stats, reducedMotion, your inspect() data
game_commandRun a command the game registered with devTools({ commands }), with JSON args
game_params / game_set_paramRead and tune typed params (validated)
game_captureThe current frame as a PNG image; path also saves it in the project (thumbnails, store art). social: true letterboxes it into 1200×675 for X and Bluesky posts (added in 0.26)
game_clipLive mode: start a rolling recording, save the last 15 s as a video in .debuff/captures/, stop. For devlogs and press kits; the human posts. Added in 0.26
game_errorsRuntime errors, explained: whose problem (your code, a rejected call, a debuff bug), the source line, a hint
game_stopClose the game. From 0.28, a headless game also closes after 15 idle minutes, and a call that takes over 60 s fails with game_hung
report_papercutReport tooling friction in debuff, keiko, myaku, spryte or debuff.jp to papercuts.debuff.jp. Returns close matches instead of filing a duplicate; call again with hit: <id> or force: true. With hit, workaround fills the papercut's workaround when it has none (from 0.24.1). Added in 0.24

Tool calls that fail on setup twice in a week, or run far too long, are reported to papercuts.debuff.jp on their own, and the result says so (see debuff papercuts in the CLI README to turn it off). From 0.24.

Prompts

Workflows clients can offer as slash commands: playtest, fix-errors, tune-feel, add-mechanic, devlog-post (added in 0.26: capture a still and a clip, then draft short posts for the human to send) and explain-stutter.

Live and headless

If you have the game open under debuff dev, game_start attaches to that tab (mode live). The overlay shows an agent badge, and every pause, step and param change the agent makes appears in its activity log, where you can undo it. Type a note in the overlay ("jump feels floaty here") to flag a moment; the agent reads it, along with the game state at that tick, through game_notes. game_stop resumes your game and disconnects.

Otherwise, or with mode: "headless", the agent gets a private copy in a headless browser. Time only advances through game_step, so what it sees is reproducible, and a scenario can replay it exactly.

来源：tooling/mcp/README.md，提交 247493d

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

24
  1. v0.32.0最新Nov 7, 2026
  2. v0.31.0Nov 6, 2026
  3. v0.29.0Nov 3, 2026
  4. v0.27.0Nov 1, 2026
  5. v0.26.2Nov 1, 2026
  6. v0.26.0Oct 31, 2026
  7. v0.24.3Oct 31, 2026
  8. v0.24.2Oct 31, 2026
  9. v0.24.0Oct 30, 2026
  10. v0.23.0Oct 30, 2026
  11. v0.21.1Oct 30, 2026
  12. v0.15.0Oct 23, 2026
  13. v0.14.0Oct 23, 2026
  14. v0.13.1Oct 22, 2026
  15. v0.13.0Oct 21, 2026
  16. v0.11.0Oct 21, 2026
  17. v0.9.5Oct 20, 2026
  18. v0.9.4Oct 20, 2026
  19. v0.9.2Oct 19, 2026
  20. v0.9.0Oct 19, 2026
  21. v0.7.1Oct 18, 2026
  22. v0.7.0Oct 18, 2026
  23. v0.6.0Oct 18, 2026
  24. v0.5.0Oct 18, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分