Permet aux agents IA d'inspecter, de construire, de tester et de jouer à des jeux web 2D en utilisant l'état en temps réel, les données de trame et le fuzzing automatisé.
Aussi connu sous debuffjp/debuff, @debuffjp/mcp
- Étoiles
- 12
- Outils
- 22
- Téléchargements, 30 jours
- 11 216
- Dernière version
- 0.35.0
- Dernier commit
- 14 nov. 2026
- Licence
- MIT
Qu'est-ce que debuff MCP ?
debuff est un serveur MCP. Permet aux agents IA d'inspecter, de construire, de tester et de jouer à des jeux web 2D en utilisant l'état en temps réel, les données de trame et le fuzzing automatisé. Il expose 22 outils, comme inspect_project, list_assets, typecheck.
Résumé généré à partir du README du projet
À propos du MCP server debuff
Ce serveur permet de construire et de tester des jeux web 2D via un agent IA. Il offre aux développeurs la possibilité d'inspecter les dépendances du projet, d'exécuter des vérifications de type en utilisant la propre configuration du projet, et de lancer des builds de production avec des rapports de taille. Le serveur fonctionne aussi bien localement en se connectant à un onglet de jeu actif qu'en exécutant une instance privée de navigateur headless pour des tests reproductibles.
Les agents peuvent interagir avec le moteur de jeu à l'aide d'outils tels que game_step pour faire progresser les étapes de simulation, game_input pour simuler des interactions clavier ou tactiles, et game_params pour ajuster des variables de jeu validées. Pour le débogage, le serveur propose game_frames pour analyser les temps de rendu et game_errors pour identifier la ligne source des problèmes d'exécution. Il inclut également un outil de fuzzing qui teste des entrées aléatoires pour trouver des crashs ou des boucles infinies, en générant automatiquement des scénarios pour rejouer ces échecs spécifiques.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer debuff MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller debuff MCP dans Claude Code
$ claude mcp add debuff -- npx -y @debuffjp/mcpInstaller debuff MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Installer debuff MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"debuff": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Installer debuff MCP dans VS Code CLI
$ code --add-mcp '{"name":"debuff","type":"stdio","command":"npx","args":["-y","@debuffjp/mcp"]}'Installer debuff MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Installer debuff MCP dans Codex
$ codex mcp add debuff -- npx -y @debuffjp/mcpInstaller debuff MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.debuff] command = "npx" args = ["-y", "@debuffjp/mcp"]
Installer debuff MCP dans Gemini CLI
$ gemini mcp add -s user debuff npx -- -y @debuffjp/mcpInstaller debuff MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}Outils MCP debuff 22
Détectés depuis le 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 | — |
Afficher les 22 outilsAfficher moins d'outils
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 | — |
Vérifications automatisées
Exécuté le 12 nov. 2026Rapport complet →A passé nos vérifications automatisées. Il ne s'agit pas d'un audit de sécurité : lisez le code et donnez au serveur l'accès le plus restreint dont il a besoin. Fonctionnement des vérifications
- Dépôt source lié et accessibleRéussi
- Licence open source (OSI)Réussi
- Commit ou version publiée au cours de l'année écouléeRéussi
- Nom du package non proche d'un package populaireRéussi
- L'endpoint distant utilise HTTPSNon vérifié
- Les outils destructifs sont étiquetésRéussi
- Aucune instruction cachée destinée au modèleRéussi
- Aucun avis critique dans le package ou ses dépendancesRéussi
README
Voir sur 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.
Questions sur debuff MCP
Comment ajouter debuff MCP à Claude Code ?
Exécutez claude mcp add debuff -- npx -y @debuffjp/mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter debuff MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Quels outils debuff MCP fournit-il ?
Il expose 22 outils, dont inspect_project, list_assets, typecheck, build, run_tests.
Comment puis-je lancer le serveur avec Claude Code ?
Vous pouvez ajouter le serveur à Claude Code en utilisant la commande : claude mcp add debuff -- npx -y @debuffjp/mcp.
L'agent IA peut-il jouer au jeu dans un navigateur ?
Oui, l'agent peut se connecter à un jeu en direct tournant dans un onglet du navigateur ou exécuter une copie privée dans un navigateur headless.
Que se passe-t-il lors d'un test de fuzzing ?
L'outil de fuzzing joue avec des entrées aléatoires, et tout crash, état bloqué ou boucle infinie est fourni avec une explication de l'erreur et un scénario reproductible.
Comment l'agent gère-t-il les erreurs d'exécution ?
L'outil game_errors fournit des explications sur les erreurs d'exécution, en identifiant la ligne source et en précisant si le problème provient de votre code, d'un appel rejeté ou d'un bug de debuff.