TypeScript parser'ları ve atıf yapılabilir konumlar kullanarak Electron uygulamalarının, binary dosyalarının, Go/Rust, .NET ve APK'ların salt okunur tersine mühendislik işlemlerini gerçekleştirir.
Ayrıca bilinen adı Firzus/agent-skills
- Yıldızlar
- 4
- Araçlar
- 8
- İndirmeler, 30 gün
- —
- En son sürüm
- 0.1.0-alpha.2
- Son commit
- 14 Kas 2026
- Lisans
- MIT
reverse-engineer MCP nedir?
TypeScript parser'ları ve atıf yapılabilir konumlar kullanarak Electron uygulamalarının, binary dosyalarının, Go/Rust, .NET ve APK'ların salt okunur tersine mühendislik işlemlerini gerçekleştirir. 8 araç sunar; örneğin triage, electron_surface, search.
Özet, projenin README dosyasından oluşturuldu
reverse-engineer MCP sunucusu hakkında
Bu sunucu, derlenmiş kodları ve Electron uygulamalarını bir AI istemcisi içerisinden analiz etmenize olanak tanır. TypeScript tabanlı parser'lar kullanarak binary dosyalarını, Go veya Rust derlemelerini, .NET assembly'lerini ve APK dosyalarını incelemek için salt okunur bir ortam sağlar. otool veya strings gibi hassas platform komutlarına güvenmek yerine, belirli dosya konumlarını, satır numaralarını veya bellek ofsetlerini içeren kompakt ve atıf yapılmış yanıtlar sunmak için özelleşmiş araçlar kullanır.
Geliştiriciler, bu sunucuyu istemci ayarlarında npx aracılığıyla bir MCP server olarak yapılandırarak kullanırlar. Node.js 24.11 veya daha yeni bir sürüm gerektirir; gelişmiş decompile ve yönetilen kod analizi için isteğe bağlı olarak Ghidra, ilspycmd ve jadx ile entegre olabilir. Performansı korumak için sunucu, çıkarımları ve analizleri SHA-256 ile önbelleğe alır ve tüm yanıtların 8 KB sınırının altında kalmasını sağlar, gerektiğinde daha büyük önbelleğe alınmış dosyalara giden yollar sunar. Bu yaklaşım, hedef kodu asla çalıştırmadan Electron IPC kanallarının, asar bütünlüğünün ve binary bölümlerinin derinlemesine incelenmesine olanak tanır.
Neler yapabilirsiniz
- 1Binary dosya özelliklerini incelemeŞüpheli bir dosyanın mimarisini, magic byte değerlerini ve derleme işaretçilerini tanımlayın.
- 2Electron uygulaması iç yapısını incelemeBir Electron uygulaması tarafından kullanılan asar çıkarımlarını, IPC kanallarını ve Node addon isimlerini inceleyin.
- 3Yönetilen kodu decompile etmeTiplerini ve fonksiyonlarını anlamak için .NET veya Android APK dosyalarını özetleyin ve decompile edin.
- 4Derlenmiş varlıklar içinde arama yapmaBir ağaç yapısı veya asar dosyası içinde belirli dize veya desenler için sınırlandırılmış bir arama gerçekleştirin.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
reverse-engineer MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a eklereverse-engineer MCP'yi Claude Code içine yükleyin
$ claude mcp add reverse-engineer -- npx -y reverse-engineerreverse-engineer MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"reverse-engineer": {
"command": "npx",
"args": [
"-y",
"reverse-engineer"
]
}
}
}reverse-engineer MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"reverse-engineer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"reverse-engineer"
]
}
}
}reverse-engineer MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"reverse-engineer","type":"stdio","command":"npx","args":["-y","reverse-engineer"]}'reverse-engineer MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"reverse-engineer": {
"command": "npx",
"args": [
"-y",
"reverse-engineer"
]
}
}
}reverse-engineer MCP'yi Codex içine yükleyin
$ codex mcp add reverse-engineer -- npx -y reverse-engineerreverse-engineer MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.reverse-engineer] command = "npx" args = ["-y", "reverse-engineer"]
reverse-engineer MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user reverse-engineer npx -- -y reverse-engineerreverse-engineer MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"reverse-engineer": {
"command": "npx",
"args": [
"-y",
"reverse-engineer"
]
}
}
}reverse-engineer MCP araçları 8
README dosyasından algılandıtriageelectron_surfacesearchreadbinary_inventorybuildinfodecompilemanaged
| triage | — | |
| electron_surface | — | |
| search | — | |
| read | — | |
| binary_inventory | — | |
| buildinfo | — | |
| decompile | — | |
| managed | — |
Otomatik kontroller
Çalıştırıldı 13 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilGeçti
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişGeçti
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokGeçti
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 soruları
reverse-engineer MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add reverse-engineer -- npx -y reverse-engineer komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
reverse-engineer MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
reverse-engineer MCP hangi araçları sunar?
8 araç sunar; bunlar arasında triage, electron_surface, search, read, binary_inventory yer alır.
Sunucu hedef kodu çalıştırabilir mi?
Hayır, araçlar kesinlikle salt okunur moddadır ve hedef dosyaları asla çalıştırmaz.
Sunucu büyük çıktıları nasıl yönetir?
Yanıtlar varsayılan olarak kompakt (8 KB altında) tutulur; daha uzun çıktılar bir önbelleğe yazılır ve yanıt, sayfalama için bir yol sağlar.
Bir binary dosyası bozuk veya zararlıysa ne olur?
Sunucu, bozuk veya zararlı binary dosyalarıyla karşılaştığında takılıp kalmak yerine kısmi sonuçlar verecek şekilde tasarlanmıştır.