Apple2

An MCP server for autonomous experimentation with Apple II control techniques via the Bobbin emulator.

Overview

This MCP server wraps the Bobbin Apple II emulator, providing tools for:

• Memory read/write access
• Screen reading
• BASIC program tokenization and injection
• Knowledge base for recording discovered techniques

Installation

pip install -e .

Usage

Configure in your Claude MCP settings:

{
  "mcpServers": {
    "apple2": {
      "command": "apple2-mcp"
    }
  }
}

Tools

Machine Control

• boot - Start the Apple II emulator (Apple II+ or //e)
• shutdown - Stop the emulator
• reset - Warm or cold reset

Memory Access

• peek / poke - Read/write memory
• load_binary - Load binary data from hex string

Screen & Graphics

• read_screen - Get 40x24 text display
• capture_gr / read_gr_ascii - Lo-res graphics (40x48, 16 colors)
• capture_hgr / read_hgr_ascii - Hi-res graphics (280x192)
• capture_dgr / read_dgr_ascii - Double lo-res (80x48, //e only)
• capture_dhgr / read_dhgr_ascii - Double hi-res (560x192, //e only)
• clear_gr - Clear lo-res screen to solid color
• clear_hgr - Clear hi-res screen to black

Input

• type_text - Type into the emulator
• send_key - Send special keys (RETURN, ESCAPE, CTRL-C, CTRL-RESET)

BASIC Execution

• run_basic - Execute BASIC command and wait for prompt
• run_and_capture - Run program and capture screen automatically
• send_keys_and_capture - Send keys to interactive program, then capture

Tokenization

• type_and_capture - Type BASIC and see tokenization
• tokenize - Tokenize BASIC source using Bobbin
• compare_tokenization - Compare against native Apple II tokenization
• inject_tokenized_basic - Direct memory injection

Disk Image Tools

• create_disk - Create new DOS 3.3 disk image
• disk_catalog - List files on disk image
• save_basic_to_disk - Save BASIC source to disk (auto-tokenizes)
• save_file_to_disk - Save .bas file to disk

Observation

• get_registers - Get 6502 CPU register state
• get_basic_pointers - Get BASIC memory pointers

Knowledge Base

• record_technique / query_techniques - Save and search techniques

Requirements

• Python 3.10+
• Bobbin emulator (compiled)
• pexpect
• mcp