TypeScriptパーサーを使用して、Electronアプリ、バイナリ、Go/Rust、.NET、APKの読み取り専用のリバースエンジニアリングを実行し、引用可能な場所を特定します。
別名 Firzus/agent-skills
- スター
- 4
- ツール
- 8
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.1.0-alpha.2
- 最終コミット
- 2026年11月14日
- ライセンス
- MIT
reverse-engineer MCPとは
TypeScriptパーサーを使用して、Electronアプリ、バイナリ、Go/Rust、.NET、APKの読み取り専用のリバースエンジニアリングを実行し、引用可能な場所を特定します。 8個のツールを提供しており、triage, electron_surface, searchなどがあります。
プロジェクトのREADMEから生成された概要
reverse-engineer MCP server について
このサーバーを使用すると、AIクライアント内からコンパイル済みのコードやElectronアプリケーションを分析できます。TypeScriptベースのパーサーを使用して、バイナリ、GoまたはRustのビルド、.NETアセンブリ、およびAPKファイルを検査するための読み取り専用環境を提供します。otoolやstringsのような不安定なプラットフォームコマンドに頼るのではなく、専用のツールを使用して、特定のファイル位置、行番号、またはメモリオフセットを含む、コンパクトで引用可能な回答を提供します。
開発者は、クライアント設定でnpx経由のMCP serverとして構成することで、このサーバーを使用できます。Node.js 24.11以降が必要です。また、高度なデコンパイルやマネージドコードの分析のために、Ghidra、ilspycmd、jadxとオプションで統合できます。パフォーマンスを維持するため、サーバーはSHA-256によって抽出と分析をキャッシュし、すべてのレスポンスが8 KBの制限内に収まるようにします。必要に応じて、より大きなキャッシュファイルへのパスを提供します。このアプローチにより、対象のコードを一切実行することなく、ElectronのIPCチャネル、asarの整合性、およびバイナリセクションの深い検査が可能になります。
できること
- 1バイナリファイルのプロパティの判別不審なファイルのアーキテクチャ、マジックバイト、およびビルドマーカーを特定します。
- 2Electronアプリケーションの内部検査Electronアプリで使用されているasarの抽出内容、IPCチャネル、およびNodeアドオンの名前を調査します。
- 3マネージドコードのデコンパイル.NETまたはAndroid APKファイルを要約およびデコンパイルして、その型や関数を理解します。
- 4コンパイル済みアセットの検索ツリーまたはasarファイル内の特定の文字列やパターンに対して、範囲を限定した検索を実行します。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
reverse-engineer MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude Codeにreverse-engineer MCPをインストール
$ claude mcp add reverse-engineer -- npx -y reverse-engineerCursorにreverse-engineer MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"reverse-engineer": {
"command": "npx",
"args": [
"-y",
"reverse-engineer"
]
}
}
}VS Codeにreverse-engineer MCPをインストール
.vscode/mcp.json
{
"servers": {
"reverse-engineer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"reverse-engineer"
]
}
}
}VS Code CLIにreverse-engineer MCPをインストール
$ code --add-mcp '{"name":"reverse-engineer","type":"stdio","command":"npx","args":["-y","reverse-engineer"]}'Claude Desktopにreverse-engineer MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"reverse-engineer": {
"command": "npx",
"args": [
"-y",
"reverse-engineer"
]
}
}
}Codexにreverse-engineer MCPをインストール
$ codex mcp add reverse-engineer -- npx -y reverse-engineerCodex config.tomlにreverse-engineer MCPをインストール
~/.codex/config.toml
[mcp_servers.reverse-engineer] command = "npx" args = ["-y", "reverse-engineer"]
Gemini CLIにreverse-engineer MCPをインストール
$ gemini mcp add -s user reverse-engineer npx -- -y reverse-engineerGemini settings.jsonにreverse-engineer MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"reverse-engineer": {
"command": "npx",
"args": [
"-y",
"reverse-engineer"
]
}
}
}reverse-engineer MCPツール 8
READMEから検出triageelectron_surfacesearchreadbinary_inventorybuildinfodecompilemanaged
| triage | — | |
| electron_surface | — | |
| search | — | |
| read | — | |
| binary_inventory | — | |
| buildinfo | — | |
| decompile | — | |
| managed | — |
自動チェック
実行日 2026年11月13日完全なレポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている合格
- モデルへの隠れた指示がない合格
- パッケージおよびその依存関係に重大な勧告なし合格
README
GitHubで見るreverse-engineer server
The read-only MCP server and CLI behind the reverse-engineer skill. The skill is the agent-facing entry point; this server replaces the commands that are missing or fragile on a given platform (otool, strings, jq, go version -m, asar extraction) with TypeScript parsers, and answers in at most 8 KB with citable locations. Installing the skill does not install the server.
Tools
| Tool | What it returns |
|---|---|
triage |
Format by magic bytes, architecture, size, SHA-256, markers (Go, Rust, Electron fuses, N-API, packers) and the next call |
electron_surface |
Cached asar extraction, main, preloads and exposeInMainWorld keys, .node addons and the addon names called from JS, IPC channels grouped by call site (app wrappers included), fuses, asar integrity |
search |
Bounded search in a tree, a .asar or one file (hidden folders included), with file:line:col or file@offset and a short excerpt |
read |
Line ranges, a column window for minified code (instead of reformatting it), hexdumps |
binary_inventory |
PE, ELF and Mach-O sections, libraries and imports, exports, Node addon names, ASCII and UTF-16 strings, PE resources |
buildinfo |
Go build info (toolchain, main package, module, settings, dependencies) and Rust cargo-auditable packages |
decompile |
Ghidra headless, cached per file: list functions, map a string to the functions that use it, return one function's C |
managed |
.NET (via ilspycmd) and APK/DEX/JAR (via jadx): decompile once, summarize, return one type |
The catalog is about 6 KB for the 8 tools; the skill is about 5.5 KB.
Design rules:
- Compact by default. Each answer stays under
REVERSE_ENGINEER_MAX_BYTES(8192). Longer output is written to the cache, and the answer ends with its path, soreadandsearchcan page through it. - Cited facts. Every location is
file:line:col,file@0xoffset, a symbol or a string. - No blocking on common cases. A
.nodefile signed after packaging shows up as an unverified hash, not as an error. Malformed or hostile binaries degrade to partial results instead of hanging. - Read-only. The tools never run the target. They write only to their cache:
%LOCALAPPDATA%\reverse-engineer\cache,~/Library/Caches/reverse-engineer, or$XDG_CACHE_HOME/reverse-engineer(override withREVERSE_ENGINEER_CACHE). Exceptions: Ghidra refuses project paths with a dot folder, so with such a cache path (the Linux default~/.cache) its projects go to a private per-user folder in the temp directory; when the cache path contains a space, Ghidra keeps its settings in the home folder; jadx and the .NET SDK may write their own settings there on first use. - Cache by SHA-256. An extraction or an analysis is reused.
Use
Requirements: Node.js 24.11 or later. Optional: Ghidra 11+ with JDK 21 for decompile, ilspycmd (.NET 10 SDK) and jadx (JDK 21) for managed. The agent can install them with the skill's install guide: official releases go into a per-user tools root (%LOCALAPPDATA%\reverse-engineer\tools, ~/Library/Application Support/reverse-engineer/tools, or $XDG_DATA_HOME/reverse-engineer/tools; override with REVERSE_ENGINEER_TOOLS), without admin rights or a PATH change. The tools look there first, then on PATH, GHIDRA_INSTALL_DIR and the usual install folders.
The package is published to npm as an alpha prerelease, reverse-engineer, and listed in the MCP Registry as io.github.Firzus/reverse-engineer. Pin the exact version:
npx -y reverse-engineer@0.1.0-alpha.2 triage ./some.exe
npx -y reverse-engineer@0.1.0-alpha.2 electron_surface "C:\Program Files\App" --focus audio,microphone
Claude Code MCP configuration (project .mcp.json):
{
"mcpServers": {
"reverse-engineer": {
"command": "npx",
"args": ["-y", "reverse-engineer@0.1.0-alpha.2", "mcp"]
}
}
}
On Windows, use "command": "cmd" with "args": ["/c", "npx", "-y", "reverse-engineer@0.1.0-alpha.2", "mcp"]. To run an unreleased build from a clone, run the Develop commands, then point the configuration at node <checkout>/mcp/reverse-engineer/dist/cli.mjs mcp.
Install the skill with npx skills add Firzus/agent-skills --skill reverse-engineer.
Develop
The toolchain is Vite+ (vite-plus, local dev dependency). .github/workflows/reverse-engineer-check.yml runs the same checks on Windows, macOS and 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
Tests against real targets are opt-in: set RE_TARGETS (a folder with app.asar, app.asar.unpacked/ and gh.exe), RE_NOTION_DIR (an installed Notion app), RE_GHIDRA=1, RE_DOTNET_DLL, or RE_APK.
Release
.github/workflows/reverse-engineer-publish.yml publishes to npm and the MCP Registry. Merging a version change to main publishes it, so treat the merge as the release decision. In the release pull request:
- Set the same version in
package.json,package-lock.json,server.json, the pinned commands above and in the skill'sSKILL.md; a unit test checks the first three. Whenvp packreports a new bundled dependency, add its license toTHIRD_PARTY_NOTICES.md. - Run the Develop checks, then
npm pack(it rebuildsdist/) and inspect the tarball:LICENSE,README.md,THIRD_PARTY_NOTICES.md,dist/cli.mjs,ghidra/ExportDecompiled.java,package.json.
The workflow stops when the version is already on npm and the MCP Registry. Otherwise it runs the check workflow, builds the tarball in a job without publishing rights, then publishes in the release environment, from a job that runs no project or dependency code. npm uses trusted publishing, with a prerelease published under its own dist-tag (alpha), never latest; the MCP Registry uses its GitHub OIDC login. A last job runs the published --version. When a run fails, fix the cause and use Re-run all jobs on that run: each publication step rechecks its registry and skips what already exists. Never overwrite or unpublish a version to hide a failed release; publish a new one.
npm must trust the workflow before the first automated release: in the reverse-engineer package settings, add a GitHub Actions trusted publisher with user Firzus, repository agent-skills, workflow reverse-engineer-publish.yml and environment release.
Benchmark
bench/ adapts the harness from leanrea to Windows and compares four arms: no skill, leanrea, REA (MCP and skill), and this tool. See bench/BENCHMARK.md for the method, the results and their limits.
License
MIT. The benchmark tasks and harness are adapted from leanrea, MIT-licensed; its notice is in bench/LICENSE-leanrea. Fuse names and the Go build-info layout follow the public formats documented by Electron and the Go toolchain; no code is copied from REA.
reverse-engineer MCPのよくある質問
reverse-engineer MCPをClaude Codeに追加するには
ターミナルでclaude mcp add reverse-engineer -- npx -y reverse-engineerを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
reverse-engineer MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
reverse-engineer MCPが提供するツールは
8個のツールを提供しており、triage, electron_surface, search, read, binary_inventoryなどがあります。
このサーバーは対象のコードを実行できますか?
いいえ、このツールは厳格に読み取り専用であり、対象のファイルを実行することはありません。
大きな出力はどのように処理されますか?
回答はデフォルトでコンパクト(8 KB未満)に保たれます。長い出力はキャッシュに書き込まれ、回答にはページング用のパスが提供されます。
バイナリが破損している、または悪意のあるものである場合はどうなりますか?
このサーバーは、破損したバイナリや悪意のあるバイナリに遭遇した場合でも、停止するのではなく、部分的な結果を返すように設計されています。