dos-mcp

Pequeñas herramientas MCP para un servidor QMP de solo bucle local de DOSBox-X. El agente GDB TraceRMI mantenido por Ghidra posee el estado del depurador; este servidor proporciona control del emulador, entrada de teclado con ritmo, lecturas de memoria limitadas, capturas de pantalla y instantáneas.

Herramientas

• dosbox_status, dosbox_pause, dosbox_resume y dosbox_reset

• dosbox_swap_floppy

• dosbox_send_keys, dosbox_key_event y dosbox_type_text

• dosbox_break_on_next_exec

• dosbox_read_memory y dosbox_capture_screen

• dosbox_save_state y dosbox_load_state

Las respuestas de memoria en línea están limitadas a 4 KiB y se devuelven en hexadecimal. Las lecturas de hasta 64 KiB pueden escribirse en su lugar en una output_path absoluta. El texto escrito se envía con ritmo y está limitado a 128 caracteres US-ASCII; es una entrada de shell cómoda, no una primitiva de teclado determinista en ciclos. Use dosbox_key_event para mantener y soltar teclas. El invitado debe consumir activamente su anillo de teclado BIOS mientras se envía texto; un programa ocupado puede perder entrada silenciosamente. Las rutas de estado deben ser rutas ASCII absolutas, y los guardados no reemplazan un archivo existente a menos que overwrite=true.

Las operaciones de entrada, reinicio, estado y captura requieren ejecución en curso. Las lecturas de memoria QMP requieren por defecto un emulador en pausa porque una lectura en ejecución puede ser incompleta; allow_running=true opta por ello explícitamente. La pausa QMP puede reanudarse mediante dosbox_resume; una parada de GDB debe continuarse a través de GDB. DOSBox-X rellena con ceros las direcciones físicas ilegibles, por lo que un byte no mapeado no puede distinguirse de un cero real a través de esta interfaz QMP. dosbox_swap_floppy avanza la lista de imágenes pre-montadas para A: o B: sin inyectar un atajo de teclado del lado del host.

Cada llamada a una herramienta abre una sesión QMP local, completa el protocolo de enlace QMP, realiza sus comandos en serie y se desconecta. Las solicitudes nunca se reintentan: una mutación con tiempo de espera agotado puede haber ocurrido ya, así que inspeccione el estado del emulador antes de repetirla.

Este servidor requiere la compilación complementaria de DOSBox-X realizada con --enable-remotedebug y configurada con [dosbox] qmpserver=true. DOSBox-X acepta un cliente QMP a la vez; no conecte otro monitor mientras use este servidor MCP.

Related MCP server: Rikune

Configuración

El servidor usa 127.0.0.1 y nunca acepta un host QMP remoto.

• DOSBOX_X_QMP_PORT tiene como valor predeterminado 4444.

• DOSBOX_X_QMP_TIMEOUT tiene como valor predeterminado 35 segundos.

Ejecute con:

uv run dos-mcp

Apache-2.0.