troed/hrdb-mcp
Watch
1
0
Fork
You've already forked hrdb-mcp
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
An MCP-exposing fork of the HRDB (Hatari Remote Debugger GUI) project
10,697 commits 1 branch 0 tags 22 MiB
  • C 75.8%
  • C++ 15.1%
  • Python 3.6%
  • Assembly 1.9%
  • Objective-C 0.9%
  • Other 2.5%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Troed Sångberg 3c695d88d8 fail on 0x hex prefix in breakpoint expressions 
Hatari requires $ prefix for hex values in breakpoint expressions.
0x silently succeeds but matches wrong values. Add validation that
rejects 0x/0X prefixes with a clear error message suggesting the
correct $ syntax. Covers set_breakpoint, launch_hatari, and
run_to_breakpoint. Also fix tool descriptions to use $ prefix.
2026-07-20 16:25:57 +02: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 New release 2.6.1, update dates in corresponding files 2025-08-15 16:03:20 +02: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 Bug fix: revert the ACIA state sync. 2025-09-28 18:53:57 +01:00
tests Merge Hatari 2.6.1 build. 2025-08-20 18:03:11 +01:00
tools fail on 0x hex prefix in breakpoint expressions 2026-07-20 16:25:57 +02: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-07-08 17:16:54 +02: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
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-07-09 12:37:41 +02:00
readme.txt New release 2.6.1, update dates in corresponding files 2025-08-15 16:03:20 +02:00

README.md

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

Quick links

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