reverse-engineer

リバースエンジニアリングサーバー

reverse-engineer スキルを支える、読み取り専用の MCP サーバーと CLI です。スキルはエージェント向けのエントリーポイントです。このサーバーは、プラットフォームによって使えなかったり不安定だったりするコマンド（otool、strings、jq、go version -m、asar の展開）を TypeScript パーサーで置き換え、引用可能な場所を示しながら、最大 8 KB で回答します。スキルをインストールしても、サーバーはインストールされません。

ツール

ツール	返される内容
triage	マジックバイトによる形式、アーキテクチャ、サイズ、SHA-256、マーカー（Go、Rust、Electron fuses、N-API、パッカー）、次の呼び出し
electron_surface	キャッシュされた asar の展開、main、プリロード、exposeInMainWorld のキー、.node アドオンと JS から呼び出されるアドオン名、呼び出し箇所ごとにグループ化された IPC チャネル（アプリラッパーを含む）、fuses、asar の整合性
search	ツリー、.asar、単一ファイル内の範囲指定検索（隠しフォルダーを含む）。file:line:col または file@offset と短い抜粋を返します
read	行範囲、（整形し直す代わりに）最小化コードの列ウィンドウ、16 進ダンプ
binary_inventory	PE、ELF、Mach-O のセクション、ライブラリとインポート、エクスポート、Node アドオン名、ASCII および UTF-16 文字列、PE リソース
buildinfo	Go のビルド情報（ツールチェーン、メインパッケージ、モジュール、設定、依存関係）と Rust の cargo-auditable パッケージ
decompile	Ghidra ヘッドレス。ファイルごとにキャッシュし、関数の一覧表示、文字列を使用する関数へのマッピング、1 つの関数の C コードを返します
managed	.NET（ilspycmd 経由）および APK/DEX/JAR（jadx 経由）。一度だけ逆コンパイルし、要約して、1 つの型を返します

8 つのツールのカタログは約 6 KB、スキルは約 5.5 KB です。

設計ルール：

• デフォルトでは簡潔に。 各回答は REVERSE_ENGINEER_MAX_BYTES（8192）未満に収まります。長い出力はキャッシュに書き込まれ、回答の末尾にそのパスが記載されるため、read と search で続きを取得できます。
• 事実には出典を示します。 場所はすべて file:line:col、file@0xoffset、シンボル、または文字列で示します。
• 一般的なケースで処理をブロックしません。 パッケージング後に署名された .node ファイルは、エラーではなく未検証のハッシュとして表示されます。不正な形式や悪意のあるバイナリでも、処理が停止することなく部分的な結果を返します。
• 読み取り専用です。 ツールは対象を実行しません。書き込み先はキャッシュのみです。キャッシュの場所は %LOCALAPPDATA%\reverse-engineer\cache、~/Library/Caches/reverse-engineer、または $XDG_CACHE_HOME/reverse-engineer です（REVERSE_ENGINEER_CACHE で上書きできます）。例外として、Ghidra はドット付きフォルダーを含むプロジェクトパスを拒否するため、そのようなキャッシュパス（Linux のデフォルトである ~/.cache など）では、プロジェクトは一時ディレクトリ内のユーザー専用フォルダーに保存されます。キャッシュパスにスペースが含まれる場合、Ghidra はホームフォルダーに設定を保持します。jadx と .NET SDK は初回使用時に、そこへ独自の設定を書き込む場合があります。
• SHA-256 でキャッシュします。 展開や解析の結果は再利用されます。

使用方法

要件：Node.js 24.11 以降。任意：decompile には Ghidra 11+ と JDK 21、managed には ilspycmd（.NET 10 SDK）と jadx（JDK 21）が必要です。エージェントは、スキルのインストールガイドを使ってインストールできます。公式リリースは、ユーザーごとのツールルート（%LOCALAPPDATA%\reverse-engineer\tools、~/Library/Application Support/reverse-engineer/tools、または $XDG_DATA_HOME/reverse-engineer/tools。REVERSE_ENGINEER_TOOLS で上書き可能）に配置され、管理者権限や PATH の変更は不要です。ツールはまずそこを検索し、次に PATH、GHIDRA_INSTALL_DIR、一般的なインストール先を検索します。

このパッケージは npm でアルファ版のプレリリースとして reverse-engineer という名前で公開されており、MCP Registry には io.github.Firzus/reverse-engineer として登録されています。バージョンを正確に指定してください：

npx -y [email protected] triage ./some.exe
npx -y [email protected] electron_surface "C:\Program Files\App" --focus audio,microphone

Claude Code の MCP 設定（プロジェクトの .mcp.json）：

{
  "mcpServers": {
    "reverse-engineer": {
      "command": "npx",
      "args": ["-y", "[email protected]", "mcp"]
    }
  }
}

Windows では、"command": "cmd" と "args": ["/c", "npx", "-y", "[email protected]", "mcp"] を使ってください。クローンから未リリースのビルドを実行するには、開発のコマンドを実行してから、設定で node <checkout>/mcp/reverse-engineer/dist/cli.mjs mcp を指定します。

npx skills add Firzus/agent-skills --skill reverse-engineer を使ってスキルをインストールしてください。

開発

ツールチェーンには Vite+（vite-plus、ローカルの開発依存関係）を使用します。.github/workflows/reverse-engineer-check.yml は、Windows、macOS、Linux で同じチェックを実行します：

npm install
npx vp check    # format, lint, type check
npx vp test     # unit tests on synthetic and hostile fixtures
npx vp pack     # bundle dist/cli.mjs, a single file with no runtime dependency

実際のターゲットを使ったテストはオプトインです。RE_TARGETS（app.asar、app.asar.unpacked/、gh.exe を含むフォルダー）、RE_NOTION_DIR（インストール済み Notion アプリ）、RE_GHIDRA=1、RE_DOTNET_DLL、または RE_APK を設定してください。

リリース

.github/workflows/reverse-engineer-publish.yml は npm と MCP Registry に公開します。バージョン変更を main にマージすると公開されるため、マージをリリースの判断として扱ってください。リリースプルリクエストでは：

1. package.json、package-lock.json、server.json、上記の固定バージョン指定コマンド、およびスキルの SKILL.md で同じバージョンを設定します。ユニットテストで最初の 3 つをチェックします。vp pack が新しいバンドル依存関係を報告した場合は、そのライセンスを THIRD_PARTY_NOTICES.md に追加してください。
2. 開発のチェックを実行し、次に npm pack（dist/ を再ビルドします）を実行して、tarball に含まれる以下のファイルを確認します：LICENSE、README.md、THIRD_PARTY_NOTICES.md、dist/cli.mjs、ghidra/ExportDecompiled.java、package.json。

バージョンがすでに npm と MCP Registry に存在する場合、ワークフローは停止します。それ以外の場合は、チェックワークフローを実行し、公開権限のないジョブで tarball をビルドした後、プロジェクトや依存関係のコードを実行しないジョブから、release 環境で公開します。npm では信頼された公開を使用し、プレリリースは独自の dist-tag（alpha）で公開します。latest には公開しません。MCP Registry では GitHub OIDC ログインを使用します。最後のジョブでは、公開済みの --version を実行します。実行が失敗した場合は原因を修正し、その実行で Re-run all jobs を使用してください。各公開ステップではレジストリを再確認し、すでに存在するものはスキップします。失敗したリリースを隠すために、バージョンを上書きしたり公開を取り消したりしないでください。新しいバージョンを公開してください。

最初の自動リリースの前に、npm でワークフローを信頼する設定が必要です。reverse-engineer パッケージの設定で、ユーザー Firzus、リポジトリ agent-skills、ワークフロー reverse-engineer-publish.yml、環境 release を指定して、GitHub Actions の信頼された公開者を追加してください。

ベンチマーク

bench/ は leanrea のハーネスを Windows 向けに調整したもので、スキルなし、leanrea、REA（MCP とスキル）、このツールの 4 つを比較します。手法、結果、およびその限界については bench/BENCHMARK.md を参照してください。

ライセンス

MIT。ベンチマークのタスクとハーネスは、MIT ライセンスの leanrea を元に調整されています。leanrea の告知は bench/LICENSE-leanrea にあります。Fuse 名と Go のビルド情報のレイアウトは、Electron と Go ツールチェーンが公開している形式に従っています。REA のコードは一切コピーしていません。