Permite que los agentes de IA inspeccionen, construyan, prueben y jueguen juegos web 2D utilizando el estado en tiempo real, datos de fotogramas y fuzzing automatizado.
También conocido como debuffjp/debuff, @debuffjp/mcp
- Stars
- 12
- Herramientas
- 22
- Descargas, 30 días
- 11.216
- Última versión
- 0.35.0
- Último commit
- 14 nov 2026
- Licencia
- MIT
¿Qué es debuff MCP?
debuff es un MCP server. Permite que los agentes de IA inspeccionen, construyan, prueben y jueguen juegos web 2D utilizando el estado en tiempo real, datos de fotogramas y fuzzing automatizado. Expone 22 herramientas, como inspect_project, list_assets, typecheck.
Resumen generado a partir del README del proyecto
Acerca del MCP server de debuff
Este servidor permite construir y probar juegos web 2D a través de un agente de IA. Proporciona a los desarrolladores una forma de inspeccionar las dependencias del proyecto, ejecutar comprobaciones de tipos utilizando la propia configuración del proyecto y realizar builds de producción con informes de tamaño. El servidor funciona tanto de forma local, conectándose a una pestaña de juego en vivo, como ejecutando una instancia privada de un navegador headless para pruebas reproducibles.
Los agentes pueden interactuar con el motor del juego utilizando herramientas como game_step para avanzar en los pasos de la simulación, game_input para simular interacciones de teclado o táctiles, y game_params para ajustar variables de juego validadas. Para la depuración, el servidor ofrece game_frames para analizar los tiempos de renderizado y game_errors para identificar la línea de origen de los problemas en tiempo de ejecución. También incluye una herramienta de fuzzing que juega con entradas aleatorias para encontrar crashes o bucles infinitos, generando automáticamente escenarios para reproducir esos fallos específicos.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar debuff MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar debuff MCP en Claude Code
$ claude mcp add debuff -- npx -y @debuffjp/mcpInstalar debuff MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Instalar debuff MCP en VS Code
.vscode/mcp.json
{
"servers": {
"debuff": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Instalar debuff MCP en VS Code CLI
$ code --add-mcp '{"name":"debuff","type":"stdio","command":"npx","args":["-y","@debuffjp/mcp"]}'Instalar debuff MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Instalar debuff MCP en Codex
$ codex mcp add debuff -- npx -y @debuffjp/mcpInstalar debuff MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.debuff] command = "npx" args = ["-y", "@debuffjp/mcp"]
Instalar debuff MCP en Gemini CLI
$ gemini mcp add -s user debuff npx -- -y @debuffjp/mcpInstalar debuff MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Herramientas de debuff MCP 22
Detectado desde el READMEinspect_projectlist_assetstypecheckbuildrun_testsrun_scenariosfuzzgame_startgame_stepgame_pausegame_framesgame_notes
| inspect_project | — | |
| list_assets | — | |
| typecheck | — | |
| build | — | |
| run_tests | — | |
| run_scenarios | — | |
| fuzz | — | |
| game_start | — | |
| game_step | — | |
| game_pause | — | |
| game_frames | — | |
| game_notes | — |
Mostrar las 22 herramientasMostrar menos herramientas
game_rewindgame_replaygame_inputgame_stategame_commandgame_capturegame_clipgame_errorsgame_stopreport_papercut
| game_rewind | — | |
| game_replay | — | |
| game_input | — | |
| game_state | — | |
| game_command | — | |
| game_capture | — | |
| game_clip | — | |
| game_errors | — | |
| game_stop | — | |
| report_papercut | — |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHub@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:
claude mcp add debuff -- npx -y @debuffjp/mcp # Claude Code
{
"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:
/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
| Tool | What it does |
|---|---|
inspect_project |
Dependencies, plugins and their contributions, assets, last build size |
list_assets |
Every asset with its type, size and importer, plus warnings and possibly unused ids |
typecheck |
Type-check with the project's own tsc; no browser needed. Vite doesn't type-check, so run it after edits |
build |
Production build plus size report; leaks must be empty |
run_tests |
Run the logic tests in tests/ (keiko): the real game in Node, no browser; failures carry the tick, scene and state |
run_scenarios |
Run scenarios/*.json headless; per-step results, errors, captures |
fuzz |
Play with random input; each crash, stuck state or back-and-forth loop comes with an explained error and a scenario that replays it |
game_start |
Attach 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_step |
Advance fixed simulation steps (pausing first); returns state (quiet leaves out your inspect() data) |
game_pause |
Pause or resume a live game |
game_frames |
Recent frame breakdown: update/render ms, catch-up steps, quads, draw calls, long tasks; summary gives percentiles and the 3 slowest |
game_notes |
Moments the human flagged in the overlay, with the state at that tick |
game_rewind |
Live mode: take the human's game back (or forward) to a tick, paused, with its exact state then |
game_replay |
Save 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_input |
press / 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_state |
Scene, tick, logical width/height, renderer, frame stats, reducedMotion, your inspect() data |
game_command |
Run a command the game registered with devTools({ commands }), with JSON args |
game_params / game_set_param |
Read and tune typed params (validated) |
game_capture |
The 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_clip |
Live 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_errors |
Runtime errors, explained: whose problem (your code, a rejected call, a debuff bug), the source line, a hint |
game_stop |
Close 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_papercut |
Report 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.
Preguntas sobre debuff MCP
¿Cómo agrego debuff MCP a Claude Code?
Ejecuta claude mcp add debuff -- npx -y @debuffjp/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego debuff MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona debuff MCP?
Expone 22 herramientas, incluidas inspect_project, list_assets, typecheck, build, run_tests.
¿Cómo puedo ejecutar el servidor con Claude Code?
Puedes añadir el servidor a Claude Code usando el comando: claude mcp add debuff -- npx -y @debuffjp/mcp.
¿Puede el agente de IA jugar al juego en un navegador?
Sí, el agente puede conectarse a un juego en vivo que se esté ejecutando en una pestaña del navegador o ejecutar una copia privada en un navegador headless.
¿Qué sucede durante una prueba de fuzzing?
La herramienta de fuzzing juega con entradas aleatorias, y cualquier cierre inesperado, estado bloqueado o bucle se entrega con un error explicado y un escenario reproducible.
¿Cómo gestiona el agente los errores en tiempo de ejecución?
La herramienta game_errors proporciona errores de ejecución explicados, identificando la línea de origen y si el problema reside en tu código, en una llamada rechazada o en un bug de debuff.