Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

HexManiacAdvance (hma-mcp)

von dewaynekuVersion 0.3.1i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.dewayneku/hma-mcp

So installierst du es

Was es kann

Hack GBA Pokémon ROMs with HexManiacAdvance's engine: tables, maps, scripts, text, undo.

Originaltext des Herstellers

  • Verbindung Läuft auf deinem Computer
  • Konto oder Schlüssel Kein Schlüssel nötig
  • Kategorie Reisen, Karten & Wetter

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 2/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

2/3 Prüfungen bestanden · Läuft auf deinem Computer

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

  1. Installationsdatei des Anbieters herunterladen

    Die .mcpb-Datei des Entwicklers herunterladen

    Die .mcpb-Datei kommt direkt vom Anbieter; wir ändern sie nicht

  2. Datei doppelklicken, dann in der Claude-Desktop-App Install klicken

  3. Ausprobieren

    Nutze HexManiacAdvance (hma-mcp) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es HexManiacAdvance (hma-mcp) nutzt, oder ein Werkzeug von HexManiacAdvance (hma-mcp) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann HexManiacAdvance (hma-mcp) noch nicht verbinden

HexManiacAdvance (hma-mcp) läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die HexManiacAdvance (hma-mcp) verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

B · Andere in Reisen, Karten & Wetter, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Claude Code kann HexManiacAdvance (hma-mcp) noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die HexManiacAdvance (hma-mcp) verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Cursor kann HexManiacAdvance (hma-mcp) noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die HexManiacAdvance (hma-mcp) verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

VS Code kann HexManiacAdvance (hma-mcp) noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die HexManiacAdvance (hma-mcp) verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die HexManiacAdvance (hma-mcp) nutzen💬 Diskussion →

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Lizenzi
Keine Lizenz angegeben
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.3.1
In der Registry veröffentlichti
15. Nov. 2026
Code zuletzt geänderti
16. Nov. 2026
Entwickler
dewayneku
Pakete
mcpb: …/hma-mcp-darwin.mcpb
mcpb: …/hma-mcp-linux.mcpb
mcpb: …/hma-mcp-win32.mcpb
Website
github.com
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 21. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto dewayneku bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 5 Tagen

  • ! Vorsicht

    Hat eine Lizenz

    GitHub konnte die Lizenzart nicht erkennen; öffne die Datei, um nachzusehen

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/dewayneku-hma-mcp.svg)](https://mcp.popnx.com/en/servers/dewayneku-hma-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Reisen, Karten & Wetteri

  • Mehr Sterne als 0 % der anderen 2083 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 83 % der anderen 2083 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 58 % der anderen 2083 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist HexManiacAdvance (hma-mcp) sicher?

Er hat 2 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 5 Tagen geändert, und die neueste Version (0.3.1) kam vor 6 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du MCPB auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

von microWachsend★ 441Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ micro.mu

Award Travel Finder

Search award flight availability and points pricing across 27 airlines and 23 loyalty programs.

von AwardTravelFinderAm Anfang★ 16Aktualisiert vor 3 Monaten

Läuft in der Cloud✓ vom Dienst · awardtravelfinder.com

Killbottleneck

Free-to-self-host goal and process maps for humans and AI agents, with REST API and MCP.

von tengolabsAm Anfang↓ 328/Wo.★ 14Aktualisiert vor 14 Tagen

Läuft auf deinem Computer✓ vom Dienst · killbottleneck.com

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

von WhimsicalCodeAm Anfang★ 11Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · whimsical.com
Im Vergleich mit ähnlichen
Dieser
HexManiacAdvance (hma-mcp)
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinJa
Basisprüfungen2/34/43/33/34/44/4
LizenzNOASSERTIONAGPL-3.0MITMITMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

An MCP server for GBA Pokémon ROM hacking.

Claude (or any MCP client) reads and edits your ROM through the engine behind HexManiacAdvance :

the same anchors, tables, script compiler and repointing, with every edit undoable and saves that open straight back up in HMA.

Quick start · Example · Tools · How it works · Contributing


Why

HMA already understands a ROM: it knows where the Pokémon stats table is, which bytes are a type, and how to recompile a script and move it if it grows. hma-mcp gives an AI assistant that same understanding, so you can describe a change in plain words and have it done correctly:

  • No GUI clicking. The assistant calls HMA's engine directly, without driving the HMA window.
  • Names, not bytes. Types, moves, species and items read and write as names (FIRE, THUNDERBOLT). A typo is rejected with suggestions instead of writing garbage.
  • Repointing handled. When a script or text grows, HMA's engine finds free space, moves it, and updates every pointer.
  • Safe by default. Nothing touches the disk until you say save, the first save backs up your original, and every edit is one undo away.

What it looks like

These are real results from a FireRed (U) 1.0 test run:

You: Open C:/hacks/firered.gba and show me Bulbasaur's base stats.

Claude: *(open_rom, read_table)* BULBASAUR: 45 HP / 49 Atk / 49 Def / 45 Spe / 65 SpA / 65 SpD, GRASS/POISON.

You: Make Charmander Fire/Dragon.

Claude: *(write_table_field)* CHARMANDER type2: FIRE → DRAGON. Not saved yet; say "undo" to revert.

You: Add a second chime to the Safari Zone time's-up script.

Claude: *(decompile_script, compile_script)* The script grew from 17 to 20 bytes and didn't fit, so HMA moved it from 1BFBC5 to free space at 71A280 and updated its 1 pointer. The anchor scripts.fromthumb.safari.end follows it.

You: Save.

Claude: *(save)* Saved firered.gba and firered.toml. Your original is backed up in .hma-mcp-backups/.

Quick start

You'll need a ROM you dumped yourself.

1. Get the server

Download the latest release. The builds are self-contained, so you don't need .NET installed.

You useDownload
Claude Desktopthe .mcpb for your system (win32, darwin for Apple Silicon Macs, linux), then double-click it
Anything elsehma-mcp- .zip / .tar.gz, unpacked somewhere permanent, e.g. %LOCALAPPDATA%\hma-mcp or ~/.local/share/hma-mcp

Keep the hma-mcp executable next to its resources/ folder. On macOS, a downloaded build is quarantined until you run xattr -dr com.apple.quarantine .

Or build it from source (needs the .NET 8 SDK )

git clone --recurse-submodules https://github.com/dewayneku/hma-mcp.git

cd hma-mcp dotnet publish src/HmaMcp -c Release -o ~/.local/share/hma-mcp

On Windows, -o %LOCALAPPDATA%\hma-mcp is a good spot, or run scripts/install.ps1, which also works while an MCP client is using the server. Publish outside the repo: an MCP client keeps the server running, and on Windows a running .exe can't be overwritten, so pointing a client at bin/ breaks your next build. To update, pull, close your MCP client (or start a new session), and run the same publish command again.

2. Connect your client

Claude Code:

claude mcp add --scope user hma -- "C:/Users/you/AppData/Local/hma-mcp/hma-mcp.exe"

--scope user makes it available in every project. Servers load when a session starts, so open a new one afterwards.

Claude Desktop (if you didn't use the .mcpb) and other MCP clients:

{

"mcpServers": { "hma": { "command": "C:/Users/you/AppData/Local/hma-mcp/hma-mcp.exe" } } }

ChatGPT and other clients that connect by URL

Some clients, like ChatGPT (Developer Mode), only connect to MCP servers on the internet over HTTPS. hma-mcp has an HTTP mode for them, plus a tunnel so the client can reach your PC:

hma-mcp --http --rom-dir "C:/hacks"
cloudflared tunnel --url http://127.0.0.1:3333

The server prints a URL with a secret token, like http://127.0.0.1:3333/mcp/3f9c.... Give your client the same path on the tunnel's address: https:// .trycloudflare.com/mcp/3f9c.... (ngrok and other tunnels work too.)

  • The token is the password. Requests without it get a 404. A new one is made each run; pass --token or set HMA_MCP_TOKEN to keep one. Clients that send headers can use Authorization: Bearer on /mcp instead.
  • `--rom-dir` is the only folder it can touch. ROMs, PNGs and saves must be inside it, and paths are shown relative to it.
  • It listens on 127.0.0.1 only. The tunnel is the only way in, and it lasts only while it's running. Stop it when you're done.

All tools work the same over HTTP. Clients that don't display images still get the text part of image tools. Tested with the included HTTP test client; ChatGPT's own setup steps change often, so check OpenAI's help center.

Then just ask, for example:

  • *"Open my ROM and list every table with 'items' in its name."*
  • *"Give Pikachu 90 base Sp. Atk and make it Electric/Steel."*
  • *"Decompile scripts.newgame.setflags and explain what it does."*
  • *"Show me Charmander's shiny sprite, then make its flame blue."*
  • *"Draw Pallet Town with its NPCs."*
  • *"Copy one of Pallet Town's houses into the empty space at the bottom, then widen Route 1 by two blocks."*
  • *"Make a new route east of Pallet Town that looks like Route 1."*
  • *"Import the ground and the dead trees from my tileset PNG into that route, then put a river and a grove on it."*
  • *"Find 512 bytes of free space."*

Tools

ToolWhat it does
📂open_rom · rom_info · close_romOpen a .gba, with HMA's .toml metadata if it's there
🔎list_anchorsSearch named anchors: data.pokemon.stats, scripts.…, graphics.…
🧭resolveAnchor or address → what's there: type of data, table row and field, pointer count
📋describe_table · read_tableTable layout, and rows as JSON: enums as names, flag sets as lists, packed fields as objects, learnsets and teams as text; filter rows with where (bank=3, map=19)
✏️write_table_fieldSet one field by row number or row name (CHARMANDER), checked against the field's size; also learnsets, TM lists, trainer teams
🗺️find_map · map_eventsFind a map by name (PALLET TOWN → 3.0), then list its NPCs, warps, trigger scripts, signs and connections, with addresses ready for write_table_field (to move or change one)
🖼️view_image · import_imageSee any sprite, tileset, tilemap or palette as an image (the assistant sees it too), save it as PNG, and import an edited PNG with HMA's palette fitting
🎨read_palette · write_paletteA palette's colors as #RRGGBB, and which graphics use it
🏞️render_mapA picture of a map, with NPCs and event markers
🧱read_map_blocks · paint_map_blocks · view_blocksetA map's blocks and movement permissions as hex grids; paint blocks (copy a building from one spot to another); see the tiles a map can use
🚪add_map_event · remove_map_event · resize_mapAdd or remove NPCs, warps, triggers and signs; grow or shrink a map (events and connections stay in place)
🆕create_map · connect_maps · disconnect_mapsNew maps modeled on an existing one (its tilesets, music, weather); join or separate neighboring maps, both sides at once
🕊️add_fly_spot · read_town_map · paint_town_mapMake a map a Fly destination; put it on the Town Map
🏷️list_region_names · add_region_nameRegion names (what a map shows on entry, on the Town Map, as a met location): which are free, and new names in free slots
🧍view_overworld_spritesA labeled sheet of NPC sprites, to pick one by number
🧩read_block · write_block · list_block_behaviors · view_tilesWhat a block is made of (8 tiles, 2 layers) and how it behaves (grass, water, door, ...); change either
🎨import_tilesetTurn a top-down PNG tileset (or several images) into a map's own tileset: ground blocks, and objects like trees and houses drawn over them with transparency; colors fitted to the GBA, duplicate and mirrored tiles shared
💬read_text · write_textGame text at an address (a script's message, say); longer text is moved and every pointer to it updated
📜decompile_script · compile_scriptEvent, battle, animation and trainer-AI scripts, with automatic repointing
⌨️hma_editType into HMA's hex view using its full edit language (^anchor, , "text")
🧱read_bytes · write_bytes · find_free_spaceRaw access, for when you need it
↩️undo · redoOne step per tool call, even when HMA records several internally
💾saveWrite the ROM and its .toml; the first save backs up the original
Games

HMA supports FireRed, LeafGreen, Emerald, Ruby and Sapphire, and hacks of them. FireRed (U) 1.0 is tested end to end with hma-mcp, and Emerald (U) passes a shorter check (tables, maps, scripts, text, save). Ruby, Sapphire and LeafGreen use the same engine but haven't been run through hma-mcp's tests yet. Reports are welcome.

How it works

flowchart LR

A["Claude / any MCP client"] <-- "MCP over stdio" --> B["hma-mcp (46 tools)"] B --> C["HexManiac.Core (HMA's engine, built from source)"] C <--> D[("your ROM .gba

  • HMA .toml metadata")]
  • HMA is a git submodule (external/HexManiacAdvance), and its core library is compiled from source by src/HexManiac.Core.Build, so the server runs exactly the editor's code.
  • ROMs open headlessly, the same way HMA's own test suite opens them.
  • compile_script follows HMA's code editor step for step: compile, move if it grew, update pointers, and keep any sub-scripts the edit left orphaned.
  • To move to a newer HMA, run git submodule update --remote external/HexManiacAdvance.

Problems found in HMA itself while building this, with fixes, are tracked in docs/hma-upstream-notes.md.

Testing

python tests/smoke.py <path-to-hma-mcp> [path/to/firered.gba]
  • With a ROM: copies it to a temp folder and edits only the copy. Checks reads, writes, enum validation, undo/redo, a script that has to move to free space, hma_edit, and a save → reopen round trip (written against FireRed (U) 1.0). tests/smoke_emerald.py runs a shorter version on Emerald (U).
  • Without a ROM: ch

Nur der Anfang wird gezeigt; den Rest findest du im Repo