arek-mcp
Provides tools for reverse-engineering Commodore Amiga games from a disk image and Kickstart ROM: ADF geometry and boot-block checksum verification, entropy/region mapping, packer detection and decrunchers (PowerPacker 2.0, Bytekiller, Atomik ATN!, Turrican II three-stage), AmigaDOS OFS/FFS file access, HUNK executable loading, copper list disassembly, 68000 flow-graph disassembly and call-tree walking, hardware-register boundary scanning, C recompilation with refusals reported, and byte-for-byte verification of the rebuild against headless emulator captures.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
amiga-re-kit (AREK)
Old Amiga games, rebuilt to run in your browser. AREK (Amiga Reverse Engineering Kit) is a free toolkit that lets an AI coding agent take a 1990s Amiga game apart, piece by piece, and build it again as a modern program: the game's own 68000 code from the disk is translated ahead of time to C and WebAssembly, the chipset is a model checked against the vAmiga emulator, and every step is measured against the original. The rebuilt game plays like the original, moves smoothly on today's screens and can show more of the level than the old window did.

Website: https://smikes75.github.io/amiga-re-kit/ (videos, the playable demo, About, FAQ; Czech mirror). Feedback: GitHub Discussions.
Status, November 2026
Alien Breed II (Team17, 1993): the whole game playable at https://arek.fun/alienbreed2/ with your own disk images (A500 version, disks 1 and 2 as
.adf; the preserved Fairlight dumps are verified, an original retail disk is not yet; AGA is not supported). Original and Enhanced modes, one or two players; levels 1–2 measured against the original, the later levels are being checked.Superfrog (Team17, 1993): the whole game playable at https://arek.fun/superfrog/ with your own four disks; Magic Woods 1–2 verified against the original with a recorded run.
The kit: version 1.0.79 on PyPI, 2819 tests. Extracted from five game rebuilds (S.W.I.V., Turrican II, Superfrog, Alien Breed, Alien Breed II) and made game-agnostic: one Python package (
arek), one command line (arek), and an MCP server (arek-mcp) so an AI assistant can drive the same instruments you do.
The method is the point: first a complete, measured description of the original, only then anything else. Nothing here guesses. The decoder refuses instructions it does not model, the walker reports every indirect jump it cannot follow, the packers verify with the checksums the originals carry, and the emulator captures are compared byte for byte.
No game data is included or needed to run the kit. The tests use
hand-assembled programs and random buffers. Your disk image and Kickstart ROM
stay on your machine, referenced from a git-ignored local.conf.
Related MCP server: Antardrishti
Install
pip install "amiga-re-kit[mcp,web]" # from PyPI; or from a checkout: pip install -e ".[mcp,dev]"
python -m pytest # 2819 tests: synthetic data + CPU timings measured on Moira
arek --helpOptional: a patched headless vAmiga
for anything that runs the original (arek shot, arek bpstate) — see
docs/HEADLESS.md. Optional: m68k-elf-objdump for
arek xref.
The workflow in commands
arek init myproject && cd myproject # skeleton + local.conf (edit the paths)
# 1. measure the disk
arek adf info disk.adf # size, sha256, boot block, checksum
arek adf map disk.adf # entropy picture, one char per sector
arek adf regions disk.adf # where code / data / packed blocks sit
arek scan disk.adf # packer signatures, verified Bytekiller blocks (formats B and BK)
# 2. unpack what the loader unpacks
arek adf track disk.adf -n 1 -o trk1.bin
arek adf ls disk.adf # AmigaDOS files, if the disk has a filesystem
arek adf cat disk.adf -p LEVELS/L1 -o l1.atn # one file, data blocks verified
arek adf build out.adf --payload image.bin --load 0x1000 --entry 0x1100 # a bootable disk that loads one memory image and jumps to it
arek pp20 file.pp -o file.bin # PowerPacker 2.0
arek bytekiller trk1.bin --offset 0x200 -o main.bin
arek t2 INTR -o intr.bin # Turrican II three-stage
arek atn BLOCK -o out.bin --offset 0x1234 # Atomik (ATN!), block inside an image
arek rnc disk.adf -o out.bin --offset 0xd5a32 # Rob Northen Compression method 1 (ProPack), both CRCs verified
arek hunk info prog && arek hunk load prog --base 0x20000 -o h # AmigaDOS executables
arek hunk split prog --chip prog2 --base 0xc00000 0x20000 -o h # records split over two files
# 3. read the code - flow graph, not linear
arek dis main.bin --base 0x20700 --walk 0x20700 # only reachable code
arek walk main.bin --base 0x20700 --start 0x20700 # call tree + frontiers
arek walk main.bin --base 0x20700 --start 0x20700 --inline 21800:until=8000 # data stored after bsr
arek hwscan main.bin --base 0x20700 --roots 0x20700 # the hardware boundary
arek copper ram.bin --base 0x0 --limit 200 # a copper list from a RAM dump
arek bpstate --address 0x21234 --end 20 --out cap/f --screenshot # RAM, chip registers and the picture
arek render cap/f # the frame RAM shows, compared with the picture
arek xref prog.txt --syms syms.json # from an objdump listing
arek dis main.bin --base 0x20700 --dcw # linear, undecodable words as dc.w
arek dis main.bin --base 0x20700 --walk 0x21234 --cycles # 68000 clock count per instruction
# 4. translate and verify
arek recomp main.bin --base 0x20700 --auto 0x21234 --main -o draw.c
arek recomp main.bin --base 0x20700 --auto 0x20700 --refusals ref.json -o game.c # every frontier as JSON
arek recomp main.bin --base 0x20700 --auto 0x20700 --overlay 41d5c:b000 --dynamic 21350 -o game.c
arek recomp intro.bin --base 0x41d5c --auto 0x41d5c --lib --prefix in_:41d5c:4cd5c --overlay-module 41d5c -o intro.c
arek recomp main.bin --base 0x20700 --auto 0x20700 --timing --profile --main -o game.c # then AREK_PROFILE=p.txt ./game ...
arek profile p.txt --by clocks # which routines to rewrite or replace (--extern) first
arek recomp main.bin --base c00000 --auto c00000 --cover --oob zero --out game.c # coverage bitmap; reads outside RAM give 0
arek cover run1.cov run2.cov game.c.cover.json # what the runs never executed (union of seeds; routines least covered first)
arek fuzz --seed 3 --frames 30000 --start 320 --out build/in3.txt # random input: the emulator (--inputs) and the rebuild alike
arek recomp main.bin --base 0x20700 --auto 0x21234 --timing \
--jtab 21300:21400:12:4:bra --indirect 21350=21500,21600 --extern 21700=load_file -o game.c
arek bpstate --address 0x21234 --end 20 --out cap/before
arek bpstate --address 0x21300 --end 20 --out cap/after
arek diff cap/before cap/after --range 0x60000 0x70000
arek shot build/shots/title 5 10 --at 3 "joystick2 press 1"
arek trace run build/l1.vtr --arm 196 --end 199 --break 0xc01106 --range 0:80000 c00000:80000
arek trace show build/l1.vtr --field px=0xc0599e:h # one row per hit, emulation never stopped
arek trace run build/l1.vtr --arm 3 --end 60 --break 0xc01106 --inputs l1.txt --reglog regs.bin # input per frame
arek trace compare build/orig.vtr build/native.vtr --best-shift 3 # long parity: where the rebuild leaves the original
arek trace bus build/bus.bin --frame 8600 # who had the chip bus in every slot (buslog patch)
arek trace run build/s.vtr --arm 3 --end 176 --shots build/f --shot-frames 8600:8619 # 20 frames, one run
arek trace run build/w.vtr --arm 3 --end 200 --break 0xc01b06 --poke c01b06:c00faa=00000002 # write into the machine, go on
arek selftest inputs # is this VAHeadless frame exact? (synthetic disk; 1.0.25: the mouse too - m<dx>:<dy>, B / C)
arek selftest mouse # RetroShell `mouse1 move dx=5 dy=-3` moves the JOY0DAT counters (vamiga-mouse-899da5d.patch)
# 4b. many scenarios at once (arek.parity.suite): state (traces), picture (--shots), sound (--reglog)
# 5. the web page: display contract wb-shell obraz 1.4 (WB-OBRAZ-CRT.md)
arek web copy web/ # the reference wb-obraz.js into the game's page (1.5: WebGL2 or 2D presenter, one API)
arek web demo # a page built on it (http://127.0.0.1:8920/demo.html)
arek web test http://localhost:8911/?test=1 # §5.1-5.4b in Chromium on both presenter paths (?gl=0 / ?gl=1) and §5.7 their equality (needs playwright)
arek web seal build/present/engine.wasm --set disk1.adf --label "disk 1, retail" --gzip --out build/present/sealed
arek web seal build/present/engine.wasm --payload build/payload.bin --payload-label "the game files" --out build/present/sealed # any disk version with the same game data opens it
arek web check build/present # a bundle: no game data, derived files sealed, manifest right
arek parity suite.json # scenarios against the original: state, picture, sound per tick
# 1.0.41: the page's life - a lost WebGL context comes back (wb-obraz 1.9, wb-scene 2.11), keys never stay down behind the
# page's back and WBTAKT.lifecycle tells hide / show (wb-takt 1.5), wb.css no longer resizes the canvas; `arek web copy`
# writes wb-kit.json and `--check` says whether a game's modules are current, stale or edited; CHANGELOG.md
# 1.0.40: found by the same audit - a callee that removes its own arguments no longer ends its caller (CALL_END goes by
# the address the rts popped), movem (An)+ with An in the list, CIA timer interrupts when the timer runs out, no bitplane
# DMA = no fetch and no sprites (selftest display), VHPOSR past the frame end; difftest with directed encodings
# 1.0.39: equal means covered - a rebuild that ends early, a side that is missing, bytes it did not capture or frames
# without a picture are differences (PROBLEM lines, exit 1; --fail: any difference is exit 1); docs/HEADLESS.md
arek web copy web/ # also wb-nastaveni.js (the shared Display / Sound menu; never overwrites a file that is not from the kit), wb-zvuk.js (sound contract 1.1), wb-atn.js + wb-content.js (the game's files from the visitor's disks)
arek web payload --atn ADF1:0x57800 ADF2:0x64a00 --out build/payload.bin --content web/content.json # the payload for --payload and the hashes the page matches
arek web serve build/present --port 8930 # the bundle with the disks of local.conf at /local-disks/diskN.adf (localhost)
arek web serve build/present --isolated # ... with the COOP / COEP headers (an engine with shared memory)
arek web strip web/page.js build/present/page.js --drop FULL # the presentation's variant: lines //@FULL and blocks //@FULL{ ... //@}FULL cut out
arek web longrun http://127.0.0.1:8930/ --minutes 3 # smoothness over a longer play (playwright; the page's globalThis.WBLONGRUN hook)
# arek web test 1.5.2 §5.5: the game canvas must lie under the presenter's .crt-layer (a scene canvas appended after it hid the CRT - Superfrog); the Screen moves the layer and warns
arek web smooth http://127.0.0.1:8920/smooth-demo.html # the canon's limits in Chromium and WebKit: dropped frames, camera and object steps, missing passes, key latency, sound under stalls (docs/WB-PLYNULOST.md; --no-interp for an original mode)
# wb-scene.js (0.9.0): the wider, smoother view composed on the GPU from one record per game frame (clean window, map, objects, sprites, HUD),
# with a CPU reference for a 0-mismatch check; scene-demo.html shows it (docs/WB-PLYNULOST.md G); 1.5: subpixel - the playfield
# moved by fractions of a device pixel (even motion on a 60 / 144 Hz display); 1.6: the objects go with the ground unless
# objects[].steady (a tracked player), unexplained() - the window's pixels the model does not explain, for window.over;
# 1.7: extrapolateObjects (the objects past the last pass, a fixed objects' latency), the HUD cached; wb-takt 1.3 fixed latencies;
# 1.8: the GPU equal to the reference at any scale (whole-number sampling since 2.0.1); arek web smooth reports key -> player when
# the page gives player(); 2.0 (kit 1.0): the contract frozen - docs/WB-RECIPE.md is the one page a game writes from; 2.1 (kit 1.0.2):
# the 0.9.15 transition and 0.9.16 freshSprites removed - counterproductive in every game (G60), the presenter's transition stays;
# wb-obraz 1.7 (kit 1.0.3): present({source | pixels + size, rect, smooth}) - a source of any size into a rectangle of the content (a hires title, an interlude)
# wb-obraz 1.8 (kit 1.0.32): new Screen(game, canvas, {crtEnhanced: 'original'}) - Enhanced that only smooths the motion keeps the Original CRT
arek web replay http://127.0.0.1:8920/scene-demo.html --hz 50,60,120,144 --frames 300 --route 1:120,2:60,0:120
# the display never touches the game: the page under a virtual clock at four rates, the same inputs by game frame, one state fingerprint (H)
arek docs WB-PLYNULOST # the kit's documents ship with it (arek docs: the list; --path: the file)
arek shots cap/shots/o build/shots/h --align 8 # the pictures of two runs paired by frame, each pair aligned for a screen shake
arek web test http://localhost:8911/?test=1 # ... and §6: the menu and the sound contract, when the page has the hooks
# 6. time inside the frame: the bus model per DMA slot (docs/BUS.md)
arek bus copy lib/ # the model's C sources into a rebuild (arek_bus_glue.h behind the translation's hooks)
arek recomp main.bin --base c00000 --auto c00000 --timing --bus-table --out game.c # bus table: words, extra accesses, flags and the bus pattern per instruction
arek roots main.bin --base c00000 --lo c00fa0 --hi c58a8c --json roots.json # static roots of a whole game (slot tables, pointer tables, stored handlers)
arek recomp main.bin --base c00000 --auto-file roots.txt --resume --out game.c # 1.0.26: tasks with their own stacks (rte / rts into another task)
arek difftest --moira ~/src/vamiga # 1.0.26: every opcode through the translation and through Moira, vAmiga's 68000
arek difftest --corpus cases.txt.gz # the same against recorded results: a C compiler is enough
arek difftest --moira ~/src/vamiga --bus-patterns buspat.json # 1.0.55: every instruction's bus cycles and interrupt sample point, measured on Moira
arek recomp main.bin --base c00000 --auto-file roots.txt --auto-soft --out game.c # a root into data is dropped, not refused
arek selftest bus # the model against this VAHeadless's bus log (synthetic program, BLTPRI blits)
arek selftest audio # the Paula model (audio DMA slots, output bytes) against this VAHeadless's logs
arek host copy lib && arek host state cap/s0 state0 # the host of a translation (docs/HOST.md) and the state a run starts from
arek host pack state0 state0.bin && arek host engine web/eng --game game.c --l3 f_c13e1c --entry f_c01c72 --run # the web engine (ASYNCIFY)
arek host engine web/eng --game game.c --l3 f_c13e1c --entry f_c01c72 --thread --run # ... in its own thread over shared memory (no ASYNCIFY; the page needs COOP/COEP)
arek --version # version + decoder/recompiler hashesEvery command prints what it measured and nothing else. arek audit profile.json produces the JSON inventory + reachability record the method
asks for (see examples/profile.example.json).
What is inside
module | what it does | origin |
| geometry, boot block checksum, entropy map / regions, inventory | new |
| AmigaDOS OFS/FFS reader (directories, files, extension blocks, checksums) + synthetic image builder for tests | new |
| PowerPacker 2.0 decruncher (+ literal-only encoder for tests) | Turrican II / Superfrog |
| Rob Northen Compression method 1 (ProPack: Huffman tables per chunk, raw bytes in the stream, the reader's prefetch discipline), both CRCs verified; a naive packer for the round-trip tests | Xenon 2 |
| Bytekiller format B (8-byte header, XOR checksum), BK (the classic 12-byte header; kit 1.0.4) and the SWIV word-stream format A | S.W.I.V., Turrican II |
| Huffman → backwards LZ → RLE three-stage decruncher | Turrican II |
| Atomik ( | Superfrog |
| brute-force scan: signatures (PP20, RNC, ATN!, IMP!, …) + verified blocks | S.W.I.V. |
| bounded HUNK reader: CODE/DATA/BSS, RELOC32, split streams; | Superfrog |
| copper list disassembler with custom register names | S.W.I.V. |
| display contract 1.5: reference module (whole device pixels, CRT canvas, layout quantum of Chromium's 1/64 px, the pixel aspect, a presenter that owns the visible canvas on WebGL2 or 2D with one API - one canvas, no copy between contexts, §3 in the shader), demo page, Chromium tests incl. the row test on both paths and their pixel equality | Turrican II, Alien Breed, Superfrog (Sonnet), Alien Breed II |
| coverage of a translation run ( | Superfrog |
| the Amiga bus per DMA slot: who owns each slot, the blitter cycle by cycle, the CPU by the accesses of its instructions - on which instruction an interrupt lands, when a blit ends, whether the original overran the frame; | Alien Breed |
| bus cycles n(r/w) of every instruction, opcode and extension words included - what a model of the Amiga bus per DMA slot needs beyond the clock count | Alien Breed |
| the translation against Moira, the 68000 of vAmiga, opcode by opcode: registers, flags, memory, where it ended and the clock count; a recorded corpus replays without Moira (1.0.26) | all of them |
| the knowledge base of the rebuilds: records of what was measured and learned (symptom, cause, check, resolution, evidence), searched by the words of the log an agent sees; the base is a folder of the user's ( | all the rebuilds |
| the method of the whole-game rebuilds (milestones, the start from the disks without a Kickstart, module discovery, the page's events at exact frames, the scene record, the public build checklist) and the Node harness that drives the wasm engine for a project's measurements | Alien Breed II, Superfrog, Turrican II |
| the host of a translation: time from the bus model, the beam, interrupts 1-6, CIA-A with the E clock, Paula, the picture line by line in C ( | Alien Breed II |
| Paula's audio DMA for the bus model: the channels' slots and output bytes, exact against the emulator ( | Alien Breed II |
| the shared Display / Sound menu of the rebuilds (same ids, ranges, defaults per mode, storage, optional zoom snapping to the whole-device-pixel zooms; the game adds its items and texts) and the sound contract 1.1: one stereo-width rule, 20 ms gain ramps, the Amiga 500's filters from the schematic in prescribed digital forms, test hooks for | Alien Breed, Superfrog |
| the Workbench 1.3 bar of a rebuild's page (Project / Display / Game / Sound / ?): an open menu or requester suspends the game, Esc and the arrow keys, a notice line; the markup is the page's (docs/WB-RECIPE.md) | Alien Breed II, Superfrog |
| the clock of a page (canon C): the game's frames allowed by the display's clock, the lock on a k x 50 Hz display, the timeline of the frames, the picture behind the game with pairs for the interpolation and extrapolation, keys at the event; the synthetic page | Alien Breed II, Superfrog (Sonnet) |
| Paula's output into Web Audio (canon D): an AudioWorklet over a ring of stereo int16 - the engine's ring in shared memory with written / read counters (a stalled main thread does not interrupt the sound, the engine computes on when the reserve runs low) or the game's frames by messages; the reserve, dropouts and output latency for the hooks | Alien Breed II, Superfrog (Sonnet) |
| touch controls for a page: a virtual stick and buttons (fire, the page's keys), shown on touch devices or with | Alien Breed II |
| the data disk a game writes (Team17's "insert your custom datadisk" for the high-score table): sectors in the host behind the game's disk routine ( | Alien Breed II, Superfrog (Sonnet) |
| the ATN! decruncher for a page (a port of the kit's, 0 differences against the games' own) and the content key: the page unpacks every ATN! block of the visitor's disks, keeps the files whose size and SHA-256 content.json lists, joins them in order - the payload of | Alien Breed II |
| code derived from a game on a public page, encrypted (AES-GCM) under a key computed from the contents of the original disk, or from the game's own content as the page's loader rebuilds it (a payload key: every disk version with the same game files opens it); opened in the browser with WebCrypto | presentation pages |
| long parity: record by record against the original's trace (first difference, addresses, phase shift); traces packed as XOR + zlib | Alien Breed, Turrican II, Superfrog (Sonnet) |
| the frame chip RAM shows: Copper timing, bitplanes, dual playfield, EHB, sprites; vAmiga's colours; 0 differing pixels on vAmiga screenshots ( | Superfrog (Sonnet), Alien Breed, Turrican II |
| strict 68000 decoder: raises | Superfrog (fixed ADDA/SUBA/CMPA); LINK/UNLK/PEA/EXG from Alien Breed; memory shifts, CMPM, ABCD/SBCD, MULS/DIVS new |
| linear and flow-walk listings straight from the decoder | new |
| which routines are pure RAM and which touch custom chips / CIA / ROM | Turrican II |
| static 68k → C recompiler with a verification driver ( | Superfrog; extensions from Alien Breed |
| 68000 clock counts per instruction, data-dependent ones included (MUL/DIV operands, shift counts, branch outcome); matches Moira on all 42 247 decodable opcodes | new |
| call / data cross references from | Superfrog |
| profile-driven inventory + conservative reachability, JSON in / JSON out | Superfrog |
|
| Turrican II / Superfrog |
| continuous trace reader/driver: VTR1 (chip RAM), VTR2 (chosen ranges), VTW2 (watchpoint + PC) | Turrican II / Alien Breed |
| byte-level comparison of captures, register diffs, "untouched" assertions | Superfrog |
| the command line and the MCP server | new |
Each module's docstring explains the format or the measurement it implements; docs/METHOD.md explains how they fit together.
MCP: let an assistant hold the instruments
pip install -e ".[mcp]"Claude Code (.mcp.json in your project, or claude mcp add arek -- arek-mcp):
{"mcpServers": {"arek": {"command": "arek-mcp"}}}The server exposes 29 tools (kit_info, kb_search, kb_get, kb_add, adf_info, adf_map, adf_ls, adf_file, scan_packed, unpack,
hunk_load, disassemble, walk, hwscan, recomp, xref, copper,
headless_shot, headless_bpstate, trace_records, diff_captures, ram_at, …).
kit_info returns the version and the SHA-256 of the decoder and recompiler;
record it with every measurement. All of them
take paths on the local machine; the server never fetches anything, never
writes outside the paths it is given, and only returns measurements — the
assistant sees entropy maps, listings and diffs, not your disk image.
A working session looks like: "map the disk" → "scan for packed blocks" → "unpack the block at 0x1f40 and walk it from its entry" → "which of these routines touch hardware?" → "recompile 0x21234 and compare its RAM writes with a capture of the original". Every answer is backed by a tool result.
Legal
The kit is MIT (see LICENSE). It ships no game data, no ROM, and no game-specific knowledge — the "engine without data" model: you supply the image you own. The vAmiga patches are modifications of MPL-2.0 sources and are published as required; see THIRD-PARTY.md.
Code comments inside the transplanted modules are partly in Czech (the projects' working language); public docstrings, the CLI and the docs are English.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Deterministic AI agent microtools, no accounts/API keys. fetch_extract: 98% token cut. 47 tools.
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
Scan AI agent skills, MCP server packages and MCP configs before you install them. Static analysis.
Self-hosted MCP server: 26 deterministic dev, security, and EVM tools.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceExposes read-only local analysis tools for source auditing, web traffic review, binary reverse engineering, exploit scaffolding, OSINT, and reporting via JSON-RPC over stdio, enabling LLMs to orchestrate evidence-based security workflows without executing targets or sending network requests.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to locally analyze and reverse engineer binaries through a compact 12-tool MCP interface for triage, function discovery, disassembly/decompilation, cross-references, strings/imports, call graphs, memory reads, annotations, and binary diffs.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to inspect and reverse-engineer large binaries through bounded stdio JSON-RPC 2.0 tools for graph queries, SSA facts, path solving, runtime grounding, and mod scaffolding.1AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to debug Commodore software in a locally running VICE emulator through its text remote monitor, inspecting registers, memory and screens, disassembling code, setting breakpoints and watchpoints, controlling execution, and working with disk images, snapshots and exported graphics. Runs locally over stdio and includes safety guidance for state-changing operations.45 npmMIT