プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

HexManiacAdvance (hma-mcp)

作者:dewaynekuバージョン 0.3.1i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.dewayneku/hma-mcp

インストール方法

できること

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

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー キー不要
  • カテゴリ 旅行・地図・天気

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア12/100

品質: 基本チェック 2/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

チェック 2/3 合格 · あなたのパソコンで動きます

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

  1. 提供元のインストールファイルをダウンロード

    作者の .mcpb ファイルをダウンロード

    .mcpb ファイルは提供元から直接のもので、当サイトは変更していません

  2. ファイルをダブルクリックし、パソコン版 Claude アプリで Install を押す

  3. 試してみる

    HexManiacAdvance (hma-mcp) を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が HexManiacAdvance (hma-mcp) を使っていると言うか、回答に HexManiacAdvance (hma-mcp) のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ HexManiacAdvance (hma-mcp) につなげません

HexManiacAdvance (hma-mcp) はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · HexManiacAdvance (hma-mcp) につなげるアプリを使う

  • キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

B · 旅行・地図・天気 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code はまだ HexManiacAdvance (hma-mcp) につなげません

提供元はパソコン版 Claude アプリ用のインストールファイルしか用意していません

代わりにできること

A · HexManiacAdvance (hma-mcp) につなげるアプリを使う

  • キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

Cursor はまだ HexManiacAdvance (hma-mcp) につなげません

提供元はパソコン版 Claude アプリ用のインストールファイルしか用意していません

代わりにできること

A · HexManiacAdvance (hma-mcp) につなげるアプリを使う

  • キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

VS Code はまだ HexManiacAdvance (hma-mcp) につなげません

提供元はパソコン版 Claude アプリ用のインストールファイルしか用意していません

代わりにできること

A · HexManiacAdvance (hma-mcp) につなげるアプリを使う

  • キー不要、インストール不要 · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?HexManiacAdvance (hma-mcp) を使っている人に聞いてみましょう💬 ディスカッション →

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
ライセンスi
ライセンスの記載なし
接続方法
パソコンで動く
最新バージョンi
0.3.1
レジストリ公開日i
2026年11月15日
コードの最終更新i
2026年11月16日
作者
dewayneku
パッケージ
mcpb: …/hma-mcp-darwin.mcpb
mcpb: …/hma-mcp-linux.mcpb
mcpb: …/hma-mcp-win32.mcpb
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

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

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月21日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント dewayneku で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:5 日前

  • ! 注意

    ライセンスがある

    GitHubがライセンスの種類を判別できませんでした。ファイルを開いて確認してください

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

未確認:バージョン付きの npm と PyPI パッケージのみ確認できます

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

旅行・地図・天気のほかのサーバーとの比較i

  • このカテゴリのほかの2083件のうち0%よりスターが多い
  • このカテゴリのほかの2083件のうち83%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2083件のうち58%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

HexManiacAdvance (hma-mcp)は安全ですか?

当てはまる基本チェック3項目のうち2項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は5 日前、最新バージョン(0.3.1)がレジストリに届いたのは6 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにMCPBも必要です。

代わりに使えるものは?

同じカテゴリには:Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Mu

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

作者:micro成長中★ 4414 か月前更新

クラウドで動く✓ micro.mu

Whimsical

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

作者:WhimsicalCode初期★ 112 か月前更新

クラウドで動く✓ 提供元 · whimsical.com
似たものと比べる
これ
HexManiacAdvance (hma-mcp)
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえはい
基本チェック2/34/43/33/34/44/4
ライセンスNOASSERTIONAGPL-3.0MITMITMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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

冒頭だけを表示しています。続きはリポジトリで読めます