dos-mcp

Kleine MCP-Werkzeuge für einen DOSBox-X-QMP-Server, der ausschließlich Loopback verwendet. Der von Ghidra gepflegte GDB-TraceRMI-Agent verwaltet den Debugger-Zustand; dieser Server liefert Emulatorsteuerung, getaktete Tastatureingaben, begrenzte Speicherlesevorgänge, Screenshots und Snapshots.

Werkzeuge

• dosbox_status, dosbox_pause, dosbox_resume und dosbox_reset

• dosbox_swap_floppy

• dosbox_send_keys, dosbox_key_event und dosbox_type_text

• dosbox_break_on_next_exec

• dosbox_read_memory und dosbox_capture_screen

• dosbox_save_state und dosbox_load_state

Inline-Speicherantworten sind auf 4 KiB begrenzt und werden als Hex zurückgegeben. Lesevorgänge bis zu 64 KiB können stattdessen in einen absoluten output_path geschrieben werden. Getippter Text wird getaktet und auf 128 US-ASCII-Zeichen begrenzt; er ist eine bequeme Shell-Eingabe, kein zyklusdeterministisches Tastatur-Primitiv. Verwenden Sie dosbox_key_event, um Tasten zu halten und loszulassen. Der Gast muss während des Sendens von Text seinen BIOS-Tastaturring aktiv konsumieren; ein ausgelastetes Programm kann Eingaben stillschweigend verlieren. Zustandspfade müssen absolute ASCII-Pfade sein, und das Speichern von Zuständen ersetzt eine vorhandene Datei nur, wenn overwrite=true gesetzt ist.

Eingabe-, Reset-, Zustands- und Erfassungsvorgänge erfordern eine laufende Ausführung. QMP-Speicherlesevorgänge erfordern standardmäßig einen pausierten Emulator, da ein Lesevorgang während des Betriebs zerrissen werden kann; allow_running=true aktiviert dieses Verhalten ausdrücklich. Eine QMP-Pause kann über dosbox_resume fortgesetzt werden; ein GDB-Stopp muss über GDB fortgesetzt werden. DOSBox-X füllt nicht lesbare physische Adressen mit Nullen, sodass ein nicht zugeordnetes Byte über diese QMP-Schnittstelle nicht von einer echten Null unterschieden werden kann. dosbox_swap_floppy rückt die vorab eingebundene Imagedateiliste für A: oder B: vor, ohne eine hostseitige Tastenkombination einzufügen.

Jeder Werkzeugaufruf öffnet eine lokale QMP-Sitzung, führt den QMP-Handshake durch, führt seine Befehle seriell aus und trennt die Verbindung. Anfragen werden nie erneut versucht: Eine Mutation mit Zeitüberschreitung kann bereits stattgefunden haben; untersuchen Sie daher den Emulatorzustand, bevor Sie sie wiederholen.

Dieser Server erfordert den zugehörigen DOSBox-X-Build, der mit --enable-remotedebug erstellt und mit [dosbox] qmpserver=true konfiguriert wurde. DOSBox-X akzeptiert jeweils einen QMP-Client; verbinden Sie keinen weiteren Monitor, während Sie diesen MCP-Server verwenden.

Related MCP server: Rikune

Konfiguration

Der Server verwendet 127.0.0.1 und akzeptiert niemals einen entfernten QMP-Host.

• DOSBOX_X_QMP_PORT hat standardmäßig den Wert 4444.

• DOSBOX_X_QMP_TIMEOUT hat standardmäßig den Wert 35 Sekunden.

Ausführen mit:

uv run dos-mcp

Apache-2.0.