1
0
Fork
You've already forked hrdb-mcp
0
An MCP-exposing fork of the HRDB (Hatari Remote Debugger GUI) project
  • C 75.8%
  • C++ 15.1%
  • Python 3.6%
  • Assembly 1.9%
  • Objective-C 0.9%
  • Other 2.5%
Find a file
Troed Sångberg d8c8bc61ae Fix MCP screenshot, capture_screen, and launch_hatari tools 
- Fix double-nested JSON in CaptureScreen, CaptureHatariScreenshot, and
 LaunchHatari return values (handler already wraps in result)
- Add MCP image content type for screenshot/capture_screen so LLMs can
 render images inline instead of receiving raw base64 text
- Allow launch_hatari to boot to desktop without a program parameter
- Fix error format in HrdbService to use __error__ key (was silently
 swallowed by SSE handler which only checks for __error__)
2026年07月09日 14:21:19 +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 Fix MCP screenshot, capture_screen, and launch_hatari tools 2026年07月09日 14:21:19 +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

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