Skip to main content
Glama
NecroVM 8080 MCP Agent Debugger

NecroVM 8080 MCP Agent Debugger

by Khanhtnq

NecroVM 8080: Resurrecting 1974 CP/M Silicon Stitched to Modern MCP Agent Debugging

Devpost Kiroween 2026 License: MIT Tests: 18/18 Passing Zero Dependencies

"Resurrecting 1974 Silicon with 2026 AI Agent Telemetry"
A cycle-accurate Intel 8080 CPU and Digital Research CP/M 2.2 BDOS emulator stitched to Anthropic Model Context Protocol (MCP) tool endpoints inside an authentic green/amber CRT phosphor terminal.

NecroVM 8080 Banner


πŸ† Devpost Kiroween 2026 Official Tracks

  • Best Resurrection ($5,000 USD): Faithful silicon restoration of the 1974 Intel 8080 8-bit microprocessor, hardware PSW flags ([SZ0A0P1C]), accurate T-state cycles, and Digital Research CP/M 2.2 BDOS syscall trap (0x0005).

  • Best Frankenstein ($5,000 USD): Stitching 52-year-old CP/M silicon to bleeding-edge 2026 Model Context Protocol (MCP) AI agents via JSON-RPC 2.0 tool definitions (necro_inspect_registers, necro_step_cycles, necro_set_breakpoint, necro_read_memory_dump, necro_assemble_and_load).

  • Best Costume Contest ($5,000 USD): Dual-phosphor P31 Green / P20 Amber CRT styling with scanline shaders, tube curvature, real-time register telemetry, and CP/M console screen.

  • Overall Grand Prize ($30,000 USD): Zero external runtime npm dependencies, 100% test coverage across 18 unit/integration tests, pure ES modules running in Node.js and web browsers.


Related MCP server: MCPEmulate

πŸ›οΈ Architecture & System Map

+-------------------------------------------------------------+
|                2026 AI Agent Ecosystem (MCP)                |
|  necro_inspect_registers | necro_step_cycles | necro_dump    |
+------------------------------+------------------------------+
                               | JSON-RPC 2.0 (Stdio/WS)
+------------------------------v------------------------------+
|                   NecroVM 8080 Engine Core                  |
|                                                             |
|  +-----------------------+     +-------------------------+  |
|  | Intel 8080 CPU Core   |     | CP/M 2.2 BDOS Subsystem |  |
|  | - 64KB RAM (Uint8)    |     | - Trap Vector 0x0005    |  |
|  | - Cycle-accurate ALU  |     | - Console BDOS I/O      |  |
|  | - S, Z, AC, P, CY PSW |     | - Virtual Disk & DMA    |  |
|  +-----------+-----------+     +------------+------------+  |
|              |                              |               |
|  +-----------v------------------------------v------------+  |
|  |             Two-Pass Intel 8080 Macro Assembler        |  |
|  |             Labels, EQU, ORG, DB, DW, Directives       |  |
|  +-------------------------------------------------------+  |
+------------------------------+------------------------------+
                               | Reactive DOM & Audio
+------------------------------v------------------------------+
|              Haunting CRT Phosphor Terminal Web UI          |
|    - P31 Green / P20 Amber  - Live Hex Dump  - Disassembly  |
+-------------------------------------------------------------+

⚑ Quickstart

1. Run Automated Test Suite

Ensure Node.js 18+ is installed. Zero npm install needed!

npm test
# Or directly:
node --test tests/test_8080.mjs

Output:

β–Ά Intel 8080 CPU Core Test Suite
  βœ” Test 01: NOP instruction advances PC and consumes 4 cycles
  βœ” Test 02: MVI and MOV register transfers
  βœ” Test 03: 16-bit LXI, INX, DCX operations
  βœ” Test 04: ADD, Carry, and Zero Flag Calculation
  βœ” Test 05: SUB, Sign Flag, and Parity Flag
  βœ” Test 06: Logic Operations: ANA, ORA, XRA
  βœ” Test 07: Stack Operations: PUSH and POP PSW
  βœ” Test 08: CALL and RET Subroutine Flow
  βœ” Test 09: Conditional Branching: JNZ vs JZ
  βœ” Test 10: DAD Double Add HL register pair
  βœ” Test 11: Rotates: RLC and RRC bit operations
  βœ” Test 12: Memory Indirect Operations: MVI M, INR M, MOV A, M
  βœ” Test 13: XCHG and XTHL exchange operations
  βœ” Test 14: CP/M 2.2 BDOS Function 2 (C_WRITE) Console Character Output
  βœ” Test 15: CP/M 2.2 BDOS Function 9 (C_WRITESTR) Console String Output
  βœ” Test 16: CP/M 2.2 BDOS Function 15 & 20 Virtual Filesystem F_OPEN & F_READ
  βœ” Test 17: Assembler8080 Two-Pass Assembly and Round-trip Execution
  βœ” Test 18: Model Context Protocol (MCP) Debugger Tool Integration
βœ” Intel 8080 CPU Core Test Suite (18/18 passing)

2. Launch the MCP Agent Debugger

node src/mcp_debugger.mjs --stdio

The server speaks JSON-RPC 2.0 conforming to Anthropic Model Context Protocol specification:

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"necro_inspect_registers"}}

3. Launch the CRT Terminal Web UI

Open docs/index.html in any modern browser. Supports live assembly editing, single-step execution, and memory hex inspection. Fully self-contained for GitHub Pages deployment.


πŸ“ Repository Structure

β”œβ”€β”€ .kiro/                       # Authentic Kiro governance directory
β”‚   β”œβ”€β”€ specs/necrovm/           # Requirements, design, and task specs
β”‚   β”œβ”€β”€ steering/                # Silicon & architecture guidelines
β”‚   β”œβ”€β”€ hooks/                   # Opcode test-on-save trigger
β”‚   └── settings/                # MCP server configuration
β”œβ”€β”€ assets/
β”‚   β”œβ”€β”€ thumbnail_1280x800.png   # Devpost promotional banner
β”‚   └── demo_kiroween_1080p.mp4  # 40s 1080p 30fps demonstration video
β”œβ”€β”€ docs/                        # Self-contained GitHub Pages terminal UI
β”‚   β”œβ”€β”€ index.html               # Dual phosphor CRT terminal interface
β”‚   └── src/                     # Packaged ES modules for web demo
β”œβ”€β”€ src/                         # Pure ES modules core
β”‚   β”œβ”€β”€ cpu8080.mjs              # Intel 8080 cycle-accurate CPU core
β”‚   β”œβ”€β”€ cpm_bdos.mjs             # CP/M 2.2 BDOS syscall trap (0x0005)
β”‚   β”œβ”€β”€ assembler8080.mjs        # Two-pass macro assembler
β”‚   └── mcp_debugger.mjs         # Anthropic MCP JSON-RPC 2.0 server
β”œβ”€β”€ tests/
β”‚   └── test_8080.mjs            # 18 unit and integration tests
β”œβ”€β”€ DEVPOST_KIROWEEN_SUBMISSION.md
β”œβ”€β”€ LICENSE                      # MIT License
└── package.json

πŸ“œ License

Distributed under the MIT License. See LICENSE for details.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides CPU emulation, disassembly, and assembly tools for LLM agents across multiple architectures including x86, ARM, and RISC-V. It enables agents to manage isolated emulation sessions, perform memory analysis, hook syscalls, and trace execution through a standard tool interface.
      41
      5
      GPL 2.0
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to code and debug Commodore PET software using the VICE emulator, with CLI and MCP tools for session control, screen reading, memory manipulation, and testing.
      44
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to run CP/M, MP/M, and DOS packages on Z80/x86 emulators, inspect byte-exact results and files, and debug the emulators themselves over the Model Context Protocol.
      7
      GPL 3.0