Regenerator2000

v1.0.0Developer Toolsstable

An interactive disassembler for the CPU 6502, focused mostly on Commodore 8-bit computers. Features a TUI with modern features like x-ref, undo/redo, arrows, keyboard-driven, mcp server, VICE debugger and more!

65026502-disassemblycommodore-64commodore64disassembler
Share:
158
Stars
0
Downloads
0
Weekly
0/5

What is Regenerator2000?

Regenerator2000 is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to interactive disassembler for the cpu 6502, focused mostly on commodore 8-bit computers. features a tui with modern features like x-ref, undo/redo, arrows, keyboard-driven, mcp server, vice debugger an...

An interactive disassembler for the CPU 6502, focused mostly on Commodore 8-bit computers. Features a TUI with modern features like x-ref, undo/redo, arrows, keyboard-driven, mcp server, VICE debugger and more!

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An interactive disassembler for the CPU 6502, focused mostly

Use Cases

An interactive disassembler for the CPU 6502, focused mostly on Commodore 8-bit
ricardoquesada

Maintainer

LicenseApache-2.0
Languagerust
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx regenerator2000

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Regenerator2000

Regenerator2000 is an interactive disassembler for the MOS 6502 CPU, purpose-built for reverse-engineering Commodore 8-bit software (C64, C128, VIC-20, Plus/4, PET). It ships both a full-featured TUI with undo/redo, cross-references, and VICE debugger integration, and an MCP server interface that lets AI assistants drive disassembly tasks programmatically — automating routine tracing, block classification, and symbol naming that would otherwise require hours of manual analysis.

Prerequisites

  • Rust toolchain installed (cargo available in PATH) to build from crates.io
  • A Commodore binary file to analyze (PRG, CRT, D64, D71, D81, T64, or VSF format)
  • An MCP-compatible client such as Claude Desktop or Claude Code
  • Optional: VICE emulator running with remote debugging enabled if you want live breakpoint integration
1

Install Regenerator2000 via Cargo

Install the latest stable release from crates.io using Cargo. This compiles the Rust binary for your platform and places it in ~/.cargo/bin.

cargo install regenerator2000
2

Verify the installation

Confirm the binary is on your PATH and check the version. The binary must be reachable for MCP clients to launch it.

regenerator2000 --version
3

Start the MCP server in stdio mode

Run the server in stdio mode so MCP clients can spawn and communicate with it over standard input/output. Use HTTP mode (--mcp-server, port 3000) for remote or multi-client setups.

regenerator2000 --mcp-server-stdio
4

Configure your MCP client

Add the server to your Claude Desktop or Claude Code configuration file. The client will automatically spawn the process when needed.

5

Load a binary for analysis

Open a Commodore binary through the TUI or pass it as an argument. Supported formats include PRG programs, CRT cartridges, D64/D71/D81 disk images, and T64 tape images.

regenerator2000 game.prg
6

Use MCP tools for automated reverse-engineering

Once connected, AI assistants can invoke MCP tools to perform disassembly manipulation, memory searches, block classification, routine tracing, and symbol naming without manual TUI interaction.

7

Export the annotated assembly

Export the disassembly in your preferred assembler format (64tass, ACME, ca65, or KickAssembler) or as HTML documentation once analysis is complete.

regenerator2000 game.prg --export_asm output.asm --assembler 64tass

Regenerator2000 Examples

Client configuration

Add Regenerator2000 to claude_desktop_config.json to enable the MCP server. The binary path must be absolute or on PATH.

{
  "mcpServers": {
    "regenerator2000": {
      "command": "regenerator2000",
      "args": ["--mcp-server-stdio"]
    }
  }
}

Prompts to try

Example prompts you can use once the MCP server is connected in your AI client.

- "Load game.prg and trace all subroutines starting from the entry point at $0801"
- "Search memory for the byte sequence EA EA EA and classify those blocks as NOP sleds"
- "Rename the subroutine at $C000 to 'init_sprites' and add a comment explaining what it does"
- "Export the fully annotated disassembly as 64tass-compatible assembly to output.asm"

Troubleshooting Regenerator2000

Command not found after cargo install

Ensure ~/.cargo/bin is in your PATH. Add 'export PATH="$HOME/.cargo/bin:$PATH"' to your shell profile and reload it.

MCP client cannot connect to the server

Verify the binary path in your config is correct. Run 'regenerator2000 --mcp-server-stdio' manually and check for startup errors. If using HTTP mode, confirm port 3000 is not blocked by a firewall.

VICE debugger connection fails

Start VICE with the remote monitor enabled: x64 -remotemonitor -remotemonitoraddress ip4://127.0.0.1:6502. Then pass --vice 127.0.0.1:6502 to regenerator2000.

Frequently Asked Questions about Regenerator2000

What is Regenerator2000?

Regenerator2000 is a Model Context Protocol (MCP) server that interactive disassembler for the cpu 6502, focused mostly on commodore 8-bit computers. features a tui with modern features like x-ref, undo/redo, arrows, keyboard-driven, mcp server, vice debugger and more! It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Regenerator2000?

Follow the installation instructions on the Regenerator2000 GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Regenerator2000?

Regenerator2000 works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Regenerator2000 free to use?

Yes, Regenerator2000 is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "regenerator2000": { "command": "npx", "args": ["-y", "regenerator2000"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Regenerator2000?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides