morluto/rea 開源逆向工程 MCP 神器教學:讓 Claude Code 與 Cursor 直接讀懂二進位與 Electron

MIT 授權開源專案 morluto/rea 透過 MCP 讓 Claude Code、Cursor 與 Gemini CLI 直接分析 Electron、.NET 與原生二進位檔,完整解析安裝與安全注意事項。

Share
morluto/rea官方 GitHub 專案封面圖:morluto rea MCP 教學
morluto/rea官方開源專案視覺圖。 圖片來源:官方原文。

看到某個桌面軟體有個超好用的功能,想研究背後怎麼實作,卻沒有原始碼嗎?

過去想拆解編譯後的執行檔、Electron 桌面應用或 Android APK,工程師必須手動打開 Ghidra、IDA 或 JADX,一步步追反編譯後的虛擬碼與函式呼叫。

開源專案 morluto/rea 把這套流程接進了 MCP。只要一行指令,Claude Code、Cursor、Codex 或 Gemini CLI 就能直接幫你讀取二進位結構並附上證據。

它不是要替你繞過授權或破解軟體,而是幫開發者合法研究互操作性、除錯或評估自家產品的曝險。

如果你常需要分析 Electron、.NET、Go、Rust 執行檔或進行安全研究,這套工具會非常省時。但如果你平常只開發一般網頁前後端,它並不在你的日常需求範圍。

以下帶你從環境需求、一鍵安裝、指令速查表到安全邊界,完整上手 morluto/rea。

morluto/rea 是什麼?核心架構怎麼運作

morluto/rea 的全名是 Reverse Engineer Anything,是一個採用 MIT 授權的開源逆向工程整合工具。它的核心目標很單純,就是把各種專業的靜態與動態分析引擎,透過模型上下文協議封裝成 AI 代理可以直接呼叫的工具集。

模型上下文協議也就是 MCP,全名為 Model Context Protocol。它就像是一套標準化的通用介面,讓大型語言模型代理能夠安全地呼叫本機工具並取得結構化回傳資料。

在傳統開發流程中,AI 程式代理只能讀懂你工作區裡的純文字原始碼。一旦遇到已經編譯好的原生二進位檔、打包後的 JavaScript ASAR 壓縮檔或 .NET 組件,代理就只能兩手一攤。

rea 填補了這個斷層。當你在 Claude Code 或 Cursor 裡提問「幫我找出這個 Electron 應用是如何實作剪貼簿橋接的」,代理會透過 MCP 呼叫對應的分析工具。分析會在你的本機端執行,接著把模組清單、匯入函式、虛擬碼或組合語言片段連同證據路徑回傳給代理。

AI 代理拿到這些證據後,就能繼續追問下一個函式,或是直接幫你整理出行為說明,甚至在你的專案裡寫出對應的功能實作與測試。除了透過 MCP 讓代理自動操作之外,你也可以直接在終端機裡執行 rea 的 CLI 指令,兩者底層共用同一套分析工作流。

在實務案例上,官方展示了多項令人驚豔的成果。例如從 16 位元 DOS 遊戲或經典 x86 遊戲中還原出音效與彈道計算函式,並以 C 或 C++ 重新編譯出完全吻合原始機械碼邏輯的程式。

另一個常見應用是分析現代桌面軟體。工程師可以用它追蹤 Notion 這類 Electron 桌面應用的渲染行程,看它如何透過預載腳本與 IPC 跨行程通訊把資料送進主行程。這套工具甚至還能將錄製下來的網頁 API 請求紀錄檔,或是 Linux 桌面應用的操作過程,轉換成可供強化學習使用的本地沙盒環境,讓代理練習各種操作任務。

延伸閱讀:Code Mode 是什麼?Claude Code 實驗功能的啟用步驟與限制

morluto/rea官方 GitHub 專案封面圖:morluto rea MCP 教學
morluto/rea官方開源專案視覺圖。 圖片來源:官方原文。

支援的分析目標與環境前置需求

rea 本身基於 Node.js 執行,根據官方 README 的規格要求,系統必須先安裝 Node.js 22.x 的 22.23.4 以上版本、24.x 的 24.22.1 以上版本,或是 26.12.1 以上版本,並搭配 npm。

如果目標是 JavaScript、Electron 或 .NET 這類靜態檔案檢查,不需要額外安裝大型反編譯引擎就能直接運作。但如果要深入分析原生 C 或 C++ 編譯出的二進位執行檔,就需要配合本地既有的反編譯工具,例如 Hopper、Ghidra、IDA 或 Kuna。

若是在 Linux 環境下執行 Ghidra、JADX、韌體工具或靜態 JavaScript 分析,系統還必須具備相容 procps 的 ps 指令,讓工具能正常檢查行程擁有權。

以下整理常見支援的目標類型與對應需求:

分析目標 回傳的分析內容 所需前置工具或引擎
JavaScript / Electron 應用 模組清單、匯入關係、Source Map、IPC 與曝光稽核 Node.js 與 npm,無需原生反編譯引擎
.NET 組件 Metadata、CIL 中介指令、宣告的原生相依與版本比對 內建靜態解析,無需額外工具
原生二進位檔 虛擬碼、組合語言、字串、符號與呼叫參考關係 需本機已安裝 Hopper、Ghidra、IDA 或 Kuna
Go 與 Rust 執行檔 內嵌編譯器版本、模組、Cargo crate 名稱與相依邊界 內建靜態 ELF、PE 與 Mach-O 解析
Android APK 與 Flutter 應用 Manifest 宣告、反編譯類別方法、簽章指紋與 Dart 雜湊 APK 深層分析需無頭版 JADX 與完整 JDK
網站與已儲存網路封包 頁面結構、腳本、網路請求紀錄與重播環境 Chrome 系列瀏覽器、HAR 或 SAZ 檔案
模型權重與 SQLite 資料庫 GGUF 與 Safetensors 張量宣告、資料表與索引結構 內建標頭解析;SQLite 需 Node 24.15 以上

這份表格涵蓋了日常工程最常碰到的目標格式。實際上該專案還支援 PyInstaller 打包檔、Deno 編譯執行檔、WebAssembly 模組、EVM 位元組碼、CUDA GPU 程式碼物件、Linux 核心模組與韌體映像檔,涵蓋範圍相當廣泛。對於離線原生二進位檔檢查,它也支援由使用者自行準備的 GNU objdump 與 Rizin 作為輔助工具。

安裝與設定教學:MCP 註冊與全域 CLI

安裝流程設計得非常乾淨。在開始之前,官方特別提醒務必確認來源為官方 GitHub 儲存庫、rea.tools 官網或 npm 上的 rea-agents 套件,不要從來路不明的鏡像安裝。

步驟一:一鍵註冊至你的 AI 程式代理

打開終端機,在一個受信任的工作目錄外執行設定精靈:

npx rea-agents setup

執行後畫面會列出偵測到的代理工具,目前支援 Claude Code、Codex、Cursor、Gemini CLI 與 Grok Build 等主流客戶端。選擇你要啟用的代理,檢視它提議修改的設定檔路徑並確認同意。

精靈會自動幫原本的設定檔建立備份,再寫入 MCP 伺服器設定與對應的工作流技能指令。完成後記得重新啟動你的 AI 代理,新的 MCP 工具就會生效。

如果你想同時使用全域終端機指令,方便隨時在命令列檢查封包或檔案,可以全域安裝 rea-agents:

npm install --global rea-agents
rea --help

步驟二:保持工具更新與 MCP 上下文最佳化

由於專案迭代速度很快,定期更新能避開許多已知錯誤。如果是透過 npm 全域安裝,可以直接執行內建更新指令:

rea update

如果是使用 Bun 全域安裝,則需確保 Bun 版本在 1.2.17 以上,再執行相同的更新指令。更新完成後,如果畫面提示需要重新整理代理設定,就再跑一次 npx rea-agents@latest setup。

在設計 MCP 時,開發團隊特別考慮到大型語言模型的上下文視窗上限。預設情況下,MCP 的 tools/list 會對外廣告精簡版的輸入結構,並省略冗長的輸出結構描述,以大幅減少佔用的 Token 數量。就算對外簡化了結構描述,伺服器端依然會進行完整的結構化驗證,確保回傳資料不打折。如果有特殊需求想啟用精簡版輸出結構廣告,可以設定環境變數 REA_MCP_OUTPUT_SCHEMA_PROFILE=compact,系統會將每個輸出結構限制在 4,096 位元組內。

步驟三:實戰呼叫代理與終端機測試

設定好之後,你可以直接在 Claude Code 或 Cursor 裡用自然語言下指令,要求代理調查某個本機應用的特定功能:

Understand how search works in the Notes app, show me the evidence, and build a similar feature for my project.

把範例中的 Notes 換成你的目標應用路徑或名稱即可。如果你想先透過終端機快速檢查一個解開的 Electron 或 JavaScript 應用程式目錄或 ASAR 檔案,並輸出 JSON 結構供其他腳本讀取,可以直接執行:

npx -y rea-agents@latest analyze-javascript-application /absolute/path/to/app --json

這行指令會輸出該應用的模組清單、匯入來源、Electron 主行程與渲染行程的通訊邊界,以及每項判斷背後的程式碼證據。如果你還想檢查打包發布後的軟體有沒有不小心把內部測試路徑或敏感資訊包進去,也可以使用它內建的 rea audit-release-exposure 來做釋出前的曝光稽核。

實戰進階:為大型二進位與強化學習環境做準備

當你開始處理體積龐大的原生二進位檔時,Ghidra 或 Hopper 這類反編譯引擎的啟動時間可能會比較長,容易超過預設逾時門檻。這時候可以透過設定環境變數 REA_GHIDRA_STARTUP_TIMEOUT_MS 或 REA_HOPPER_STARTUP_TIMEOUT_MS,手動拉長等待引擎啟動的毫秒數。

另一個實務上的小細節是 macOS 上的 Hopper 首次啟動。工具會在需要時自動喚起 Hopper,但如果你是第一次在 Mac 上使用,它可能會跳出一個選擇試用模式或輸入授權序號的對話框。在讓無人值守的代理執行任務前,建議先在同一個使用者工作階段中手動開啟一次 Hopper 並完成該對話框,才不會讓自動化流程卡住。

除了逆向分析,如果你對強化學習環境建置有興趣,這套工具也提供了把錄製好的瀏覽器請求紀錄檔 .har 轉成可執行代理環境的指令。這需要本機額外搭配 AgentEnv 與 Docker:

rea environment-build ./session.har ./my-env --name my-env --json
agent-env run ./my-env

這個工作流能把網站的操作介面轉換成對應的工具呼叫。為了避免誤改正式資料,生成的環境只會在錄製紀錄確認過效果的操作上允許變更狀態,非常適合用來測試或訓練自家代理的任務完成率。系統甚至能從一句自然語言需求出發,在 Linux 機器上透過 Docker 自動組裝出包含截圖、滑鼠與鍵盤操作的桌面應用練習環境。

延伸閱讀:Anthropic 宣布 2027 年起將高風險資安漏洞揭露期從 90 天縮至 30 天:AI 挖漏洞太快,軟體修補來得及嗎?

安全邊界、授權合規與常見踩雷點

使用這套逆向工具時,最需要看清楚的是資料隱私、執行權限與軟體授權這三條紅線。

首先在資料安全方面,所有的目標檔案分析都在你的本機端完成,工具本身不會把整個執行檔上傳到第三方伺服器。但是要記住,你的 AI 代理會收到回傳的虛擬碼、字串與模組結構作為上下文。這些回傳內容接著會被送往你所使用的模型供應商進行推理,因此敏感專案仍須遵守所屬模型供應商的資料隱私政策。

其次是動態執行風險。靜態 JavaScript 與 .NET 檢查只會讀取檔案內容,不會真的執行目標程式。但如果你使用了行程行為擷取或網頁觀察功能,工具就會在你的使用者權限下啟動或操作目標程式。千萬不要對來路不明的可疑惡意程式直接開啟執行時期擷取,務必在隔離環境或虛擬機中進行。

第三點則是商業工具的授權合規。雖然這個專案本身是 MIT 開源授權,但它整合的 IDA Pro、Hopper 或 JEB 都屬於商業軟體。官方文件明確強調,使用者必須自行合法取得這些工具的授權,嚴禁使用破解版或繞過試用限制,且商業工具的自動化條款仍受原廠商規範限制。

最後提醒一個常見踩雷點:如果你在 Linux 系統上執行 Electron 分析或啟動 Ghidra 失敗,九成是因為容器或精簡版發行版缺少了完整的 procps 相容 ps 指令,導致行程檢查報錯。遇到這類情況時,安裝完整的 procps 套件通常就能順利解決。

延伸閱讀:Apple 宣布 macOS 27.3 拆分裝置控制與資料存取權限:AI 代理時代的 Mac 資安新防線

常見問題

使用這套逆向工具一定要先安裝 Ghidra 或 IDA 嗎?

不一定。如果你的目標是分析 JavaScript、Electron 應用、.NET 組件、Go 執行檔的模組清單或 Rust 套件相依,這些都屬於內建靜態解析,不需要安裝任何原生反編譯引擎就能運作。只有需要針對 C 或 C++ 等原生二進位檔產生虛擬碼與組合語言時,才需要搭配 Ghidra、Hopper、IDA 或 Kuna。

只從 skills.sh 安裝技能包,而不執行 setup 可以嗎?

不建議。從 skills.sh 安裝的技能檔只提供給代理看的調查工作流說明書,並沒有幫你的代理註冊底層的 MCP 伺服器。正確的做法是執行 npx rea-agents setup,讓精靈一併完成 MCP 註冊與對應技能安裝,接著重啟代理。

為什麼我在 MCP 工具清單裡看不到完整的輸出 Schema?

這是開發團隊刻意做的上下文最佳化。為了避免龐大的 JSON Schema 塞爆 AI 代理的上下文視窗,預設會省略輸出結構廣告,只在伺服器端做嚴格驗證。如果有除錯或整合需求,可設定環境變數 REA_MCP_OUTPUT_SCHEMA_PROFILE=compact 來開啟精簡版輸出結構。

透過 npx 執行 setup 後,可以把暫存目錄刪掉嗎?

要小心。使用 npx 執行 setup 時,設定檔裡會記錄當下解析出來的執行時期與入口腳本路徑。如果你把套件快取清除掉了,代理下次啟動 MCP 時可能會找不到腳本。若是長期使用,建議透過 npm install --global rea-agents 全域安裝後再進行設定。

結語

總結來說,morluto/rea 適合需要進行跨技術棧除錯、確認第三方函式庫行為、研究舊版軟體邏輯或稽核自家 Electron 應用發布風險的資安人員與資深工程師。

相對地,如果你平常只處理有完整原始碼的純網頁專案,或者不希望將任何反編譯片段送往雲端大型語言模型,那麼這個工具就沒有納入日常工作流的必要。在合法授權與隔離環境的前提下,把逆向分析交給 AI 代理跑第一輪證據蒐集,確實能省下大量人工翻找符號表的時間。

想每週掌握最新爆紅的開源 AI 開發工具與實戰攻略,歡迎免費訂閱 AI 郵報。

資料來源

Read more