dos-mcp

用于仅回环的 DOSBox-X QMP 服务器的小型 MCP 工具。Ghidra 维护的 GDB TraceRMI 代理拥有调试器状态；该服务器提供模拟器控制、节奏键盘输入、有界内存读取、截图和快照。

工具

• dosbox_status、dosbox_pause、dosbox_resume 和 dosbox_reset

• dosbox_swap_floppy

• dosbox_send_keys、dosbox_key_event 和 dosbox_type_text

• dosbox_break_on_next_exec

• dosbox_read_memory 和 dosbox_capture_screen

• dosbox_save_state 和 dosbox_load_state

内联内存响应限制为 4 KiB，并以十六进制返回。最多 64 KiB 的读取可以改为写入绝对 output_path。键入的文本有节奏限制，最多 128 个 US-ASCII 字符；它是方便的 shell 输入，不是周期确定性的键盘原语。使用 dosbox_key_event 来按住和释放按键。发送文本时，客户机必须主动消耗其 BIOS 键盘环；繁忙的程序可能会静默丢失输入。状态路径必须是绝对 ASCII 路径，除非 overwrite=true，否则保存不会替换现有文件。

输入、重置、状态和捕获操作需要运行中的执行。QMP 内存读取默认要求模拟器暂停，因为运行中的读取可能被撕裂；allow_running=true 明确选择该行为。QMP 暂停可以通过 dosbox_resume 恢复；GDB 停止必须通过 GDB 继续。DOSBox-X 对不可读的物理地址进行零填充，因此通过此 QMP 接口无法区分未映射的字节和真实的零。dosbox_swap_floppy 推进 A: 或 B: 的预挂载镜像列表，而无需注入主机端键盘快捷键。

每次工具调用都会打开一个本地 QMP 会话，完成 QMP 握手，串行执行其命令，然后断开连接。请求从不重试：超时的变更可能已经发生，因此在重复之前检查模拟器状态。

此服务器需要配套的 DOSBox-X 构建，该构建使用 --enable-remotedebug 制作，并配置了 [dosbox] qmpserver=true。DOSBox-X 一次只接受一个 QMP 客户端；使用此 MCP 服务器时，请勿附加其他监视器。

Related MCP server: Rikune

配置

服务器使用 127.0.0.1，从不接受远程 QMP 主机。

• DOSBOX_X_QMP_PORT 默认为 4444。

• DOSBOX_X_QMP_TIMEOUT 默认为 35 秒。

运行：

uv run dos-mcp

Apache-2.0.