An MCP-exposing fork of the HRDB (Hatari Remote Debugger GUI) project
  • C 75.7%
  • C++ 15.2%
  • Python 3.6%
  • Assembly 1.9%
  • Objective-C 0.9%
  • Other 2.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Troed Sångberg 041890089b
Some checks failed
build-linux / build (push) Failing after 4s
fix(mcp): adapt to upstream hwregs protocol and decode_buf signature
Rebasing onto tattlemuss/hatari hrdb-main (7d5ee51e) brought two API
changes into the models the MCP layer consumes:

- YmState was replaced by HwRegs: GetYm() -> GetHwRegs(), and the
  ymChangedSignal() signal is now hwRegsChangedSignal(). The "hwregs"
  response still lists the 16 YM2149 registers first, so get_ym_state
  keeps returning exactly those (MFP registers are not exposed).
- Disassembler::decode_buf() gained a pcSplit argument; pass -1 to
  disable PC-row splitting, matching mainwindow/registerwidget, since
  the disassemble tool has no PC context.
2026-11-17 13:44:37 +00:00
.github/workflows Attempt to stop Github Actions suddenly failing when installing Qt via apt 2025-09-07 21:40:07 +01:00
ci Add script for compiling capsimg with mingw 2025-03-09 12:12:44 +01:00
cmake Merge commit '60063edb9e' into hrdb-main 2025-08-01 13:26:48 +01:00
doc chore(hygiene): replace internal hostnames/paths with placeholders; add public repo hygiene notes 2026-11-17 13:42:11 +00:00
python-ui Merge Hatari 2.6.1 build. 2025-08-20 18:03:11 +01:00
share Add french translations to *.desktop + remove unneeded 'Version' 2020-11-06 10:48:27 +01:00
src Clean whitespace formatting. 2026-07-11 11:17:37 +01:00
tests Merge Hatari 2.6.1 build. 2025-08-20 18:03:11 +01:00
tools fix(mcp): adapt to upstream hwregs protocol and decode_buf signature 2026-11-17 13:44:37 +00:00
.cirrus.yml Bump libpng version to 1.6.48 2025-06-01 13:17:25 +02:00
.gitignore feat: add SSE transport, progress events, and run_to_breakpoint tool 2026-11-17 13:42:11 +00:00
.gitlab-ci.yml Use Fedora 41 for the MinGW job to avoid problem with mingw64-sdl2-compat 2025-06-07 14:59:42 +02:00
.travis.yml Update the Travis jobs from "focal" to "jammy" 2025-06-01 12:40:06 +02:00
AGENTS.md chore(hygiene): replace internal hostnames/paths with placeholders; add public repo hygiene notes 2026-11-17 13:42:11 +00:00
CMakeLists.txt Merge Hatari 2.6.1 build. 2025-08-20 18:03:11 +01:00
configure Add a switch to enable the undefined behavior sanitizer 2025-01-06 19:32:37 +01:00
gpl.txt Update the GPL text in the documentation 2025-05-02 22:28:16 +02:00
hatari.spec New release 2.6.1, update dates in corresponding files 2025-08-15 16:03:20 +02:00
README.md Early release of skills to aid in debugging and optimizing 2026-11-17 13:42:11 +00:00
readme.txt New release 2.6.1, update dates in corresponding files 2025-08-15 16:03:20 +02:00

hrdb-mcp

This is a fork of the Hatari Atari ST emulator hrdb (Hatari Remote Debugger) GUI fork with an added MCP (Model Context Protocol) server for LLM integration.

This repository contains three layers in one tree:

Layer What
Hatari core Upstream Hatari 2.6.1 emulator — Atari ST/STE/TT/Falcon emulation
https://framagit.org/hatari/hatari
hrdb Unofficial Hatari fork — Qt GUI for remote debugging
https://github.com/tattlemuss/hatari/
hrdb-mcp additions MCP server (SSE transport) exposing Hatari debugging as LLM-callable tools

LLM agent skills

LLM-based coding agents can use these skills (SKILL.md files) as context when working with the hrdb MCP server:

Skill Location Purpose
debug tools/hrdb/skills/debug/SKILL.md How to trace Atari ST code and identify bugs — breakpoints, memory areas, traps, exception vectors, graphics capture
optimize tools/hrdb/skills/optimize/SKILL.md How to optimize 68000 assembly for the Atari ST — instruction timing, cycle-counting techniques, Yacht v1.1 reference