winuae-mcp-plugin
xphileby/winuae-mcp-plugin
Claude Code plugin: drive a real Amiga (WinUAE) from Claude - input synthesis, screenshots, debugging, serial I/O. Bundles emulator + MCP server + skill.
Instalação
npx convez-ai xphileby/winuae-mcp-plugin1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
README
A tradução para o português deste README ainda está na fila.
winuae-mcp — Claude Code plugin
Drive a real Amiga from Claude. This plugin bundles:
bin/winuae64.exe— WinUAE (x64, optimized) with an embedded MCP/JSON-RPC server (~46 tools: input synthesis, screenshots, CPU/memory inspection, breakpoints, serial I/O, disk & save-state management, machine control).server/mcp-winuae-bridge.py— a resilient stdio↔TCP relay registered as thewinuaeMCP server. Start Claude and the emulator in any order; the server stays available and reports emulator reachability via thewinuae_statustool.skills/winuae— a skill teaching Claude the operating patterns for gaming, programming/testing, and 68k debugging on the emulated Amiga.
Install
/plugin marketplace add xphileby/winuae-mcp-plugin
/plugin install winuae-mcp@winuae-mcp
Requirements: Windows x64, Python 3.8+ available as py (the Windows
launcher).
Use
You must supply your own Amiga Kickstart ROM and a .uae config (ROMs are
copyrighted; none are bundled). Then either ask Claude to launch the emulator,
or run it yourself:
& "$env:USERPROFILE\.claude\plugins\<...>\winuae-mcp\bin\winuae64.exe" -f my.uae
The emulator listens on TCP 7843 (all interfaces, no auth — see Security). Ask Claude things like:
- "Boot the Workbench HDF and open the Prefs window with the mouse"
- "Insert game.adf, hard-reset, turbo through loading, screenshot the title"
- "Mount C:\proj\build as a volume and run mytool from a Shell, capture SER: output"
- "Set a breakpoint at 0xF8159C and show me the registers when it hits"
Security
The embedded server binds 0.0.0.0:7843 without authentication. Anyone who
can reach the port controls the emulator (input, memory, files visible to the
guest). Use on trusted networks, or firewall the port / rebuild with loopback
binding.
Source & license
WinUAE is GPL-licensed; this distribution includes a modified build
("mcpbridge"). Complete corresponding source for the included binary:
https://github.com/xphileby/WinUAE-mcpbridge (public; fork of
https://github.com/tonioni/WinUAE, base tag 6030, branch mcpbridge-6030).
Plugin scaffolding (relay, skill, manifests): GPL-2.0-or-later, same as the emulator.