dos-mcp

루프백 전용 DOSBox-X QMP 서버를 위한 소형 MCP 도구 모음입니다. Ghidar의 유지 관리형 GDB TraceR 에이전트가 디버거 상태를 소유하며, 이 서버는 에뮬레이터 제어, 박자에 맞춘 키보드 입력, 제한된 메모리 읽기, 스크린샷 및 스냅샷을 제공합니다.

도구

• 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

인라인 메모리 응답은 4KiB로 제한되며 16진수로 반환됩니다. 최대 64KiB의 읽기는 절대 output_path에 기록할 수 있습니다. 입력된 텍스트는 박자에 맞춰 입력되며 128자의 US-ASCII 문자로 제한됩니다. 이는 편리한 셸 입력 방식이지, 사이클 결정적 키보드 기본 요소가 아닙니다. dosbox_key_event를 사용하여 키를 누르거나 놓을 수 있습니다. 게스트는 BIOS 키보드 링 버퍼를 적극적으로 소비해야 하며, 텍스트가 전송되는 동안 바쁜 프로그램은 입력을 조용히 잃을 수 있습니다. 상태 경로는 절대 ASCII 경로여야 하며, overwrite=true가 아닌 이상 저장은 기존 파일을 대체하지 않습니다.

입력, 재설정, 상태 및 캡처 작업은 실행 중인 에뮬레이션이 필요합니다. QMP 메모리 읽기는 기본적으로 일시 중지된 에뮬레이터를 요구하는데, 실행 중인 읽기는 중단될 수 있기 때문입니다. allow_running=true는 이를 허용합니다. QMP 일시 중지는 dosbox_resume을 통해 재개할 수 있으며, GDB 중지는 GDB를 통해 계속되어야 합니다. DOSBox-X는 읽을 수 없는 물리적 주소를 0으로 채우므로, 매핑되지 않은 바이트는 이 QMP 인터페이스를 통해 실제 0과 구별할 수 없습니다. dosbox_swap_floppy는 호스트 측 키보드 단축키를 주입하지 않고 A: 또는 B: 드라이브의 사전 마운트된 이미지 목록을 전진시킵니다.

각 도구 호출은 로컬 QMP 세션을 열고, QMP 핸드셰이크를 완료하며, 명령을 직렬로 수행하고, 연결을 끊습니다. 요청은 재시도되지 않습니다. 시간 초과된 변경은 이미 발생했을 수 있으므로, 반복하기 전에 에뮬레이터 상태를 검사하십시오.

이 서버는 --enable-remotedebug로 빌드되고 [dosbox] qmpserver=true로 구성된 동반 DOSBox-X 빌드가 필요합니다. 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.