Yapay zeka ajanlarının gerçek zamanlı durum, kare verileri ve otomatik fuzzing kullanarak 2D web oyunlarını incelemesine, oluşturmasına, test etmesine ve oynamasına olanak tanır.
Ayrıca bilinen adı debuffjp/debuff, @debuffjp/mcp
- Yıldızlar
- 12
- Araçlar
- 22
- İndirmeler, 30 gün
- 11.216
- En son sürüm
- 0.35.0
- Son commit
- 14 Kas 2026
- Lisans
- MIT
debuff MCP nedir?
debuff bir MCP sunucusudur. Yapay zeka ajanlarının gerçek zamanlı durum, kare verileri ve otomatik fuzzing kullanarak 2D web oyunlarını incelemesine, oluşturmasına, test etmesine ve oynamasına olanak tanır. 22 araç sunar; örneğin inspect_project, list_assets, typecheck.
Özet, projenin README dosyasından oluşturuldu
debuff MCP sunucusu hakkında
Bu sunucu, bir yapay zeka ajanı aracılığıyla 2D web oyunları oluşturmayı ve test etmeyi mümkün kılar. Geliştiricilere proje bağımlılıklarını inceleme, projenin kendi yapılandırmasını kullanarak tip kontrolleri (type-checks) çalıştırma ve boyut raporlarıyla birlikte üretim derlemeleri (production builds) yürütme imkanı sağlar. Sunucu, hem canlı bir oyun sekmesine bağlanarak hem de tekrarlanabilir testler için özel bir headless tarayıcı örneği çalıştırarak yerel olarak çalışır.
Agentlar; simülasyon adımlarını ilerletmek için game_step, klavye veya dokunmatik etkileşimleri simüle etmek için game_input ve doğrulanmış oyun değişkenlerini ayarlamak için game_params gibi araçları kullanarak oyun motoruyla etkileşime girebilirler. Hata ayıklama için sunucu, render sürelerini analiz etmek için game_frames ve çalışma zamanı sorunlarının kaynak satırını belirlemek için game_errors sunar. Ayrıca, çökmeleri veya sonsuz döngüleri bulmak için rastgele girdilerle oynayan ve bu spesifik hataları yeniden oynatmak için otomatik olarak senaryolar oluşturan bir fuzzing aracı içerir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
debuff MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekledebuff MCP'yi Claude Code içine yükleyin
$ claude mcp add debuff -- npx -y @debuffjp/mcpdebuff MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}debuff MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"debuff": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}debuff MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"debuff","type":"stdio","command":"npx","args":["-y","@debuffjp/mcp"]}'debuff MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}debuff MCP'yi Codex içine yükleyin
$ codex mcp add debuff -- npx -y @debuffjp/mcpdebuff MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.debuff] command = "npx" args = ["-y", "@debuffjp/mcp"]
debuff MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user debuff npx -- -y @debuffjp/mcpdebuff MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"debuff": {
"command": "npx",
"args": [
"-y",
"@debuffjp/mcp"
]
}
}
}debuff MCP araçları 22
README dosyasından algılandıinspect_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 | — |
22 aracın tümünü gösterDaha az araç göster
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 | — |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
@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.
debuff MCP soruları
debuff MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add debuff -- npx -y @debuffjp/mcp komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
debuff MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
debuff MCP hangi araçları sunar?
22 araç sunar; bunlar arasında inspect_project, list_assets, typecheck, build, run_tests yer alır.
Claude Code ile sunucuyu nasıl çalıştırabilirim?
Sunucuyu şu komutu kullanarak Claude Code'a ekleyebilirsiniz: claude mcp add debuff -- npx -y @debuffjp/mcp.
Yapay zeka ajanı oyunu bir tarayıcıda oynayabilir mi?
Evet, ajan bir tarayıcı sekmesinde çalışan canlı bir oyuna bağlanabilir veya headless bir tarayıcıda özel bir kopya çalıştırabilir.
Fuzz testi sırasında ne olur?
Fuzz aracı rastgele girdilerle oynar; meydana gelen çökmeler, takılma durumları veya döngüler, açıklanmış bir hata ve yeniden oynatılabilir bir senaryo ile birlikte sunulur.
Ajan çalışma zamanı hatalarını nasıl yönetir?
game_errors aracı, hata kaynağını belirleyerek açıklanmış çalışma zamanı hataları sunar; sorunun kodunuzda mı, reddedilen bir çağrıda mı yoksa bir debuff hatasında mı olduğunu tespit eder.