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に制限され、16進数で返されます。最大64 KiBまでの読み取りは、代わりに絶対パスの output_path に書き込むことができます。入力されるテキストはペース調整され、128 US-ASCII文字に制限されます。これは便利なシェル入力であり、サイクル決定的なキーボードプリミティブではありません。キーの押下と解放には dosbox_key_event を使用してください。テキスト送信中は、ゲストがBIOSキーボードリングを能動的に消費している必要があります。ビジーなプログラムは静かに入力を失う可能性があります。状態パスは絶対ASCIIパスである必要があり、overwrite=true でない限り、保存時に既存ファイルは置き換えられません。

入力、リセット、状態、キャプチャ操作は、実行中のエミュレーションを必要とします。QMPメモリ読み取りは、実行中の読み取りが不整合になる可能性があるため、デフォルトで一時停止中のエミュレータを必要とします。allow_running=true はそれを明示的にオプトインします。QMPの一時停止は dosbox_resume で再開できます。GDBの停止はGDBを通じて継続する必要があります。DOSBox-Xは読み取り不能な物理アドレスをゼロで埋めるため、このQMPインターフェースを通じて、未マップのバイトを実際のゼロと区別することはできません。dosbox_swap_floppy は、ホスト側のキーボードショートカットを注入せずに、A: または B: のプリマウント済みイメージリストを進めます。

各ツール呼び出しは、1つのローカルQMPセッションを開き、QMPハンドシェイクを完了し、そのコマンドを直列に実行して切断します。リクエストは再試行されません。タイムアウトした変更はすでに発生している可能性があるため、繰り返す前にエミュレータの状態を確認してください。

このサーバーは、--enable-remotedebug を指定してビルドされ、[dosbox] qmpserver=true で構成された、対応するDOSBox-Xビルドを必要とします。DOSBox-Xは一度に1つの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.