TypeScript 파서를 사용하여 Electron 앱, 바이너리, Go/Rust, .NET 및 APK를 읽기 전용으로 역공학하며, 인용 가능한 위치 정보를 제공합니다.
다른 이름 Firzus/agent-skills
- 스타
- 4
- Tools
- 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 정보
이 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 addon 이름을 조사합니다.
- 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
reverse-engineer MCP는 어떤 도구를 제공하나요?
8개 도구를 제공합니다. 예: triage, electron_surface, search, read, binary_inventory.
서버에서 대상 코드를 실행할 수 있나요?
아니요, 도구는 엄격하게 읽기 전용으로 작동하며 대상 파일을 절대 실행하지 않습니다.
대용량 출력은 어떻게 처리하나요?
기본적으로 답변은 8 KB 미만으로 간결하게 유지됩니다. 더 긴 출력은 캐시에 저장되며, 답변에는 페이징을 위한 경로가 제공됩니다.
바이너리가 손상되었거나 악성인 경우 어떻게 되나요?
서버는 손상되었거나 악성인 바이너리를 만났을 때 멈추는 대신, 부분적인 결과라도 반환하도록 설계되었습니다.