dos-mcp

Небольшие MCP-инструменты для QMP-сервера DOSBox-X, работающего только через loopback. Поддерживаемый 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 КиБ и возвращаются в виде hex. Чтение до 64 КиБ можно вместо этого записать в абсолютный 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: без внедрения хост-ярлыка клавиатуры.

Каждый вызов инструмента открывает одно локальное 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.