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,698 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 7e162b169b
Some checks failed
build-linux / build (push) Failing after 2s
Details
chore(hygiene): replace internal hostnames/paths with placeholders; add public repo hygiene notes
2026-09-06 11:36:28 +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 chore(hygiene): replace internal hostnames/paths with placeholders; add public repo hygiene notes 2026-09-06 11:36:28 +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 chore(hygiene): replace internal hostnames/paths with placeholders; add public repo hygiene notes 2026-09-06 11:36:28 +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
AGENTS.md chore(hygiene): replace internal hostnames/paths with placeholders; add public repo hygiene notes 2026-09-06 11:36:28 +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