Tags: simen/vice-mcp

v1.0.1 - Protocol fixes and semantic layer improvements

- DisplayGet: API v2 support, correct body parsing (157KB screenshots working)
- writeMemory: Fixed body format (8-byte header + data)
- step(): Use AdvanceInstructions command
- Request ID: 4 bytes, not 1 byte
- ensureStopped(): Added before memory/display operations

- Sprite address validation with region/severity/warning diagnostics
- Skip debug logging for large responses (>1KB)
- Integration test suites for protocol and MCP tool layers

- Protocol tests: 5/5 passing (Connect, RegistersGet, MemoryGet, MemorySet, DisplayGet)
- MCP tool tests: 16/16 passing (all semantic layer tools)

VICE MCP v1.0.0 - Initial Release

An MCP server that enables AI agents to autonomously debug C64 code via the
VICE emulator's binary monitor protocol.

- **readScreen**: Decodes C64 PETSCII screen to readable text
- **readVicState**: Full VIC-II state with graphics mode interpretation
- **readSprites**: All 8 sprites with visibility diagnostics
- **readSidState**: SID audio chip state interpretation

- Memory read/write with hex and ASCII display
- CPU registers with flag interpretation
- Breakpoints and watchpoints
- Program loading and execution control
- Step/continue debugging

- Structured output (value + name + hint)
- Actionable error messages
- Diagnostic visibility reasons for sprites
- Color names instead of raw values

```bash
npx github:simen/vice-mcp

claude mcp add vice -- npx github:simen/vice-mcp
```

- VICE emulator with binary monitor enabled
- Node.js 18+

Tested with VICE 3.9 binary monitor on port 6502.