Apple II控制实验服务器

Apple II MCP服务器

MCP服务器，用于通过Bobbin仿真器对Apple II控制技术进行自主实验。

概述

此MCP服务器封装了Bobbin Apple II仿真器，提供以下工具：

• 内存读/写访问
• 屏幕阅读
• BASIC程序标记化和注入
• 用于记录所发现技术的知识库

安装

pip install -e .

用法

在Claude MCP设置中配置：

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

工具

机器控制

• boot -启动Apple II模拟器（Apple II+或//e）
• shutdown -停止模拟器
• reset -热重置或冷重置

内存访问

• peek / poke -读/写存储器
• load_binary -从十六进制字符串加载二进制数据

屏幕和图形

• read_screen -获得40x24文本显示
• capture_gr / read_gr_ascii -低分辨率图形（40x48，16色）
• capture_hgr / read_hgr_ascii -高分辨率图形（280x192）
• capture_dgr / read_dgr_ascii -双分辨率（80x48，//仅限e）
• capture_dhgr / read_dhgr_ascii -双高分辨率（560x192，//仅限e）
• clear_gr -将低分辨率屏幕变为纯色
• clear_hgr -将高分辨率屏幕清除为黑色

输入

• type_text -在模拟器中键入
• send_key -发送特殊按键（返回、退出、CTRL-C、CTRL-RESET）

基本执行

• run_basic -执行BASIC命令并等待提示
• run_and_capture -自动运行程序并捕获屏幕
• send_keys_and_capture -将密钥发送到交互式程序，然后捕获

分词

• type_and_capture -键入BASIC并查看标记化
• tokenize -使用Bobbin标记BASIC源代码
• compare_tokenization -与原生Apple II代币化进行比较
• inject_tokenized_basic -直接内存注入

磁盘映像工具

• create_disk -创建新的DOS 3.3磁盘映像
• disk_catalog -列出磁盘映像上的文件
• save_basic_to_disk -将BASIC源保存到磁盘（自动标记）
• save_file_to_disk -将.bas文件保存到磁盘

观察

• get_registers -获取6502 CPU寄存器状态
• get_basic_pointers -获取BASIC内存指针

知识库

• record_technique / query_techniques -保存和搜索技术

需求

• Python 3.10+
• Bobbin仿真器（编译）
• pexpect
• 主控程序