Kling Digital
tr
İletişim
2026-11-18
12 dk okuma
Öne Çıkan Rehber

REA (Reverse Engineer Anything) Nedir, Nasıl Kurulur? Yapay Zekâ Ajanlarıyla Tersine Mühendislik ve MCP Mimarisi

REA (morluto/rea — Reverse Engineer Anything), MIT lisanslı açık kaynaklı bir CLI ve Model Context Protocol (MCP) sunucusudur. Yapay zekâ kodlama ajanlarını Ghidra, Hopper, IDA Pro, JADX ve yerleşik statik ayrıştırıcılara bağlayarak kaynak kodu olmayan ikili dosyaları, Electron paketlerini ve çalışma zamanı davranışlarını kanıt tabanlı analiz eder.

REA (Reverse Engineer Anything) Nedir, Nasıl Kurulur? Yapay Zekâ Ajanlarıyla Tersine Mühendislik ve MCP Mimarisi

Kapalı kaynaklı bir masaüstü uygulamasının milisaniye altı yerel arama indeksini nasıl kurduğunu, bir Electron paketinin preload katmanından ana sürece hangi IPC kanallarını açtığını veya derlenmiş bir ikili dosyanın ağ imzalama mantığını anlamaya çalıştığınızda, asıl darboğaz nadiren tek bir aracın eksikliğidir. Gerçek zaman kaybı; Ghidra sembol tabloları, Hopper sözde kod pencereleri, JADX sınıf ağaçları ve HAR ağ kayıtları arasında bağlam taşırken oluşur. GitHub üzerinde kısa sürede 466.000'i aşkın yıldız toplayan morluto/rea (REA — Reverse Engineer Anything), tam olarak bu orkestrasyon kopukluğunu gidermek üzere tasarlanmış bir mühendislik katmanıdır.

REA (rea-agents), MIT lisanslı açık kaynaklı bir komut satırı aracı (CLI) ve Model Context Protocol (MCP) sunucusudur (io.github.morluto/rea). Tek başına kapalı kodları sihirli biçimde kıran bir decompiler olmak yerine; Claude Code, Cursor, Codex ve Gemini CLI gibi kodlama ajanlarını yerel statik analiz işçilerine, Ghidra, Hopper, IDA Pro, Kuna ve JADX gibi endüstri standardı tersine mühendislik motorlarına bağlayarak kanıt, belirsizlik sınırı ve sözde kod üretir.

Yönetici Özeti ve Mimari Çıkarımlar
  • Sihirli Klonlama Değil, Kanıt Tabanlı MCP Orkestrasyonu: REA; ikili dosyaları, .asar arşivlerini ve derlemeleri yerel makinenizde inceler, fonksiyon referanslarını kanıtlarıyla (evidence) haritalandırır ve ajanın bu bulgular üzerinden temiz bir yeniden uygulama yazmasını sağlar.
  • Bağlam Penceresi (Context) Disiplini: Kompakt giriş şeması profili ve 4.096 baytlık çıkış şeması bütçesi (REA_MCP_OUTPUT_SCHEMA_PROFILE=compact) sayesinde büyük ikili analizlerde LLM jeton (token) taşmasını önler; komut çıktılarını 4 MiB sınırında tutar.
  • Kurumsal Savunma Zorunluluğu: İstemci tarafına gönderilen Electron .asar paketleri, kaynak haritaları (source maps) ve gizlenmemiş API uç noktaları artık dakikalar içinde haritalanabilmektedir; kritik iş kuralları sunucu tarafında izole edilmelidir.

Kurumsal ürün ekiplerinde kurumsal yapay zekâ çözümleri ve ajan tabanlı geliştirme hatları yaygınlaştıkça, hem mevcut eski (legacy) ikili sistemlerin belgelenmesi hem de dışa açılan istemci paketlerinin güvenlik denetimi özel yazılım geliştirme süreçlerinin doğrudan bir parçası haline gelmiştir. Bu rehberde REA'nın resmi v6.9.0 mimarisini, kurulum adımlarını, CI/CD maruziyet denetimini ve kurumsal güvenlik etkilerini birincil kaynak verileriyle inceliyoruz.


1. REA Mimarisinin Çekirdeği: Decompiler Değil, Kanıt Tabanlı MCP Köprüsü

Sosyal medyadaki yüzeysel paylaşımların aksine REA, sıfırdan özel mülkiyetli kaynak kodu "halüsinasyonla tahmin eden" bir araç değildir. Node.js ^22.23.4 || ^24.22.1 || >=26.12.1 çalışma zamanı üzerinde saf ESM ("type": "module") yapısıyla çalışan sistem, ajanın doğal dildeki araştırma sorusunu deterministik analiz adımlarına böler.

REA MCP Köprüsü ve Çok Katmanlı Analiz Mimarisi
Şekil 1: REA MCP sunucusunun kodlama ajanından gelen sorguları yerleşik statik işçilere, native decompiler köprülerine ve çalışma zamanı yakalayıcılarına dağıtma mimarisi.

Bağlam Bütçesi ve Şema Sıkıştırma Tasarımı

Standart bir tersine mühendislik aracının ham sembol tablosunu doğrudan bir dil modeline göndermek, birkaç çağrı içinde yüz binlerce jetonluk bağlam penceresini doldurur. REA resmi dokümantasyonu bu darboğazı üç mimari mekanizmayla çözer:

  1. Kompakt Giriş Şeması Profili: MCP sunucusu tools/list aşamasında gereksiz şema şişkinliğini atarak kompakt giriş şemaları yayınlar; buna karşın sunucu tarafında kanonik tip ve parametre doğrulamasını eksiksiz korur.
  2. Sıfır Varsayılan Çıkış Şeması Yükü: Model API'leri çıkış şemalarını doğrudan okumadığı için REA varsayılan olarak bunları tools/list yanıtından çıkarır ve her sonucu kendi içinde doğrular. İhtiyaç halinde REA_MCP_OUTPUT_SCHEMA_PROFILE=compact ortam değişkeni ile her çıkış şeması 4.096 bayt bütçesiyle sınırlandırılabilir.
  3. İzole İşçi Süreçleri ve 4 MiB Çıktı Tavanı: JavaScript ve web paket analizleri ana süreci bloklamamak için ayrı işçi süreçlerinde (#javascript-analysis-worker ve #web-bundle-analysis-worker) yürütülür; güncelleyici ve alt komut çıktıları terminal geri basıncına (backpressure) uyarak en fazla 4 MiB stdout/stderr tutar.

2. Kurulum, Ortam Hazırlığı ve Doğrudan CLI İş Akışları

REA hem yapay zekâ ajanınıza MCP sunucusu olarak bağlanabilir hem de doğrudan terminalden tekil komutlarla çalıştırılabilir. Linux ortamlarında Ghidra, JADX ve statik Electron analizlerinin süreç sahipliğini doğrulayabilmesi için procps uyumlu sistem ps aracının kurulu olması gerekir.

Adım 1: Ajan Entegrasyonu ve Otomatik Kurulum

Node.js (22.23.4+) ve npm kurulu bir iş istasyonunda hedef projenin dışındaki güvenilir bir dizinden kurulum sihirbazı başlatılır:

# Ajanları algılar, mevcut ayarların yedeğini alır ve MCP sunucusunu kaydeder
npx rea-agents setup
# Düzenli terminal kullanımı için global CLI kurulumu
npm install --global rea-agents
# Bağlı decompiler ve sağlayıcıların sağlık kontrolü
rea doctor --json
# Global kurulumu doğrulanmış akışla güncelleme
rea update

Kurulum sihirbazı Claude Code, Cursor, Codex, Gemini CLI ve Grok Build yapılandırmalarını otomatik tanır; değişiklikleri uygulamadan önce onayınıza sunar ve mevcut yapılandırma dosyalarını yedekler. İşlem tamamlandığında ajanınızı yeniden başlatmanız yeterlidir.

Adım 2: Harici Motor Gerektirmeyen Statik JS / Electron Analizi ve CI Denetimi

Paketlenmiş bir Electron uygulamasını (.asar) veya web paketini incelemek için Ghidra ya da IDA Pro kurulumuna ihtiyaç yoktur. Aşağıdaki üretim tipi TypeScript örneği, dağıtım öncesinde kendi masaüstü veya web paketinizin dışarıya sızdırdığı kaynak haritalarını, IPC sınırlarını ve iç rotaları otomatik denetleyen bir CI/CD kontrol kapısını göstermektedir:

import { execFile } from "node:child_process";
import { promisify } from "node:util";
import path from "node:path";
const execFileAsync = promisify(execFile);
export interface ReaJsModuleFinding {
  readonly modulePath: string;
  readonly imports: readonly string[];
  readonly ipcChannels: readonly string[];
  readonly hasSourceMap: boolean;
}
export interface ReaJsAnalysisReport {
  readonly targetPath: string;
  readonly electronBoundaries: readonly string[];
  readonly modules: readonly ReaJsModuleFinding[];
  readonly limitations: readonly string[];
}
export async function runReaBundleExposureGate(
  rawAppDirectory: string,
): Promise<{ passed: boolean; violations: string[]; report: ReaJsAnalysisReport }> {
  const resolvedTarget = path.resolve(rawAppDirectory);
  const { stdout } = await execFileAsync(
    "npx",
    ["-y", "rea-agents@latest", "analyze-javascript-application", resolvedTarget, "--json"],
    {
      timeout: 120_000,
      maxBuffer: 4 * 1024 * 1024, // REA 4 MiB tanı tavanıyla uyumlu tampon
      windowsHide: true,
    },
  );
  const report = JSON.parse(stdout) as ReaJsAnalysisReport;
  const violations: string[] = [];
  for (const mod of report.modules) {
    if (mod.hasSourceMap) {
      violations.push(`Üretim paketinde açık source map tespit edildi: ${mod.modulePath}`);
    }
  }
  return {
    passed: violations.length === 0,
    violations,
    report,
  };
}

3. İncelenebilen Hedef Katmanlar: Statik Analizden Native Binary ve RL Ortamlarına

REA v6.9.0 sürümü itibarıyla 30'dan fazla ikili ve çalışma zamanı formatını tek bir kanıt şemasında birleştirir:

A. Harici Decompiler Gerektirmeyen Yerleşik Statik Analizler

Uygulamayı hiç çalıştırmadan (sıfır kod yürütme riskiyle) doğrudan dosya başlıkları ve bayt dizilimleri üzerinden çalışan modüllerdir:

  • JavaScript, Web ve Electron: Modül grafikleri, source map kalıntıları, yönlendirme tabloları, preload ve IPC sınırları, yerel eklentiler (native add-ons) ve rea audit-release-exposure yayın sızıntısı taraması.
  • Derlenmiş Modern Diller (Go, Rust, .NET, Deno, PyInstaller): Go ikili dosyalarında gömülü derleyici sürümü ve modül değişimleri; Rust derlemelerinde cargo-auditable bağımlılık ağacı; .NET derlemelerinde CIL talimatları; PyInstaller CArchive içerikleri ve Deno compile sanal dosya sistemleri.
  • Oyun Motorları, Yapay Zekâ Modelleri ve İkili Sertleştirme: Unity IL2CPP (global-metadata.dat sürüm 24, 27, 29, 31 ve 39), Godot PCK arşivleri, GGUF ve safetensors tensör başlıkları, CUDA/HIP/PTX GPU nesneleri, Windows PE Authenticode (PKCS#7/X.509) imzaları ve ELF/PE/Mach-O güvenlik bayrakları (PIE, NX, RELRO, CFG).

B. Derin Native Decompiler Köprüleri

C, C++ veya assembly düzeyinde kontrol akışı ve sözde kod gerektiğinde REA; sisteminizde kurulu olan Hopper (hopper_bridge.py), Ghidra (ReaGhidraBridge.java — 16-bit DOS, MIPS ve RISC-V çağrı kuralları dahil), IDA Pro, Kuna, Cutter/Rizin ve JEB (REA_JEB_MCP_URL) motorlarını köprüler. Büyük ikili dosyalarda başlatma zaman aşımı REA_GHIDRA_STARTUP_TIMEOUT_MS veya REA_HOPPER_STARTUP_TIMEOUT_MS ile esnetilebilir.

C. Mobil, Firmware, Ağ Kayıtları ve Pekiştirmeli Öğrenme (RL) Ortam Sentezi

Headless JADX, ADB ve Apktool ile Android APK ve cihaz incelemesi; Binwalk / Unblob ile firmware bölge çıkarımı; WABT ile WebAssembly (inspect_wasm_artifact); evmole ile çevrimdışı EVM akıllı kontrat seçici analizi desteklenir. Ayrıca kaydedilmiş bir tarayıcı HAR oturumunu alıp rea environment-build ./session.har ./my-env --name my-env --json komutuyla yapay zekâ ajanlarının orijinal uygulamayı çalıştırmadan üzerinde görev pratiği yapabileceği deterministik bir AgentEnv (RL) ortamına dönüştürebilir.


4. Karşılaştırmalı Mimari Matris: Geleneksel Süreç vs. REA Orkestrasyonu

Değerlendirme KriteriGeleneksel Manuel Tersine MühendislikHam LLM Kopyala-Yapıştır YaklaşımıREA (MCP + Kanıt Tabanlı Orkestrasyon)
Araçlar Arası Bağlam GeçişiAnalist Ghidra, JADX, HAR ve terminal arasında manuel veri taşırGeliştirici parçalı decompile çıktılarını sohbet penceresine elle yapıştırırAjan, tek MCP protokolü üzerinden 30+ hedef aracını doğrudan sorgular
Halüsinasyon ve Kanıt KontrolüYüksek doğruluk ancak tamamen insan hızına bağımlıEksik bağlamda uydurma fonksiyon mantığı üretme riski yüksekHer bulgu sembol, ofset, referans kanıtı ve bilinen sınırlarla (limitations) döner
Token ve Bağlam MaliyetiModel kullanılmazHam çıktılar bağlam penceresini hızla taşırırKompakt giriş şeması + 4.096 bayt çıkış profili + 4 MiB çıktı sınırı
Electron / JS Sızıntı DenetimiManuel asar extract ve tek tek dosya taramasıBüyük bundle dosyalarını tek seferde okuyamazİzole işçi süreçleriyle modül, IPC ve audit-release-exposure haritası çıkarır
RL ve Ajan Test Ortamı ÜretimiSıfırdan sahte (mock) API sunucusu kodlamayı gerektirirDesteklemezHAR kayıtlarından doğrulanmış AgentEnv görev ortamı dışa aktarır

5. Doğrulanmış Saha Örnekleri: DX-Ball, Notion IPC Köprüsü ve 16-Bit Rekonstrüksiyon

REA'nın resmi vitrininde yer alan üç doğrulanmış vaka çalışması, aracın "kodu sihirli biçimde kopyalamak" yerine kanıt tabanlı yeniden inşa için nasıl çalıştığını somut biçimde gösterir:

  1. DX-Ball Ses Konumlandırma (Sound-Pan) Hesabı: Orijinal x86 ikili dosyasındaki ses çağrısı takip edilerek eksik sözde kod C diline dönüştürülmüş; üretilen fonksiyon 3.205 orijinal x86 test vakasını eksiksiz geçmiş ve derlenmiş 63 fonksiyon baytının tamamını birebir yeniden üretmiştir.
  2. Notion Masaüstü Pano (Clipboard) Köprüsü: Electron renderer sürecindeki pano API'sinden başlanarak preload betiği ve IPC kanalları üzerinden main sürecine uzanan zengin pano veri formatı uçtan uca haritalandırılmıştır.
  3. TH04 (PC-98) 16-Bit Mermi Halkası Matematiği: Klasik PC-98 oyununun 16-bit DOS talimatları incelenerek sabit ve hedefli açı hesaplamaları C++ dilinde yeniden kurulmuş ve tarihsel derleyici çıktısıyla doğrulanmıştır.

6. Kopyala-Yapıştır Hazır REA Ajan Prompt Şablonları

Kurulum (npx rea-agents setup) tamamlandıktan sonra Claude Code, Cursor veya Gemini CLI içinde doğrudan kullanabileceğiniz dört kanıt odaklı inceleme şablonu aşağıdadır. Pazarlama ve reklam verilerinde MCP protokolünün nasıl çalıştığını görmek için kardeş rehberimiz olan Claude ve Meta Ads MCP Entegrasyonu yazısını da inceleyebilirsiniz.

# 1. Electron (.asar) Preload ve IPC Güvenlik Sınırı Haritalama
REA kullanarak /mutlak/yol/app.asar paketini statik olarak incele.
Renderer sürecinden preload ve ipcMain katmanına açılan tüm IPC kanallarını,
parametre doğrulaması eksik uçları ve kalmış source map dosyalarını kanıtlarıyla listele.
# 2. Native İkili Dosyada Algoritma ve Çağrı Grafiği Çıkarımı (Ghidra / Hopper)
REA üzerinden /mutlak/yol/hedef-binary dosyasındaki paket imzalama veya sıkıştırma
fonksiyonunu bul. Sembol adreslerini, çağıran/çağrılan fonksiyon zincirini, sözde kodu
ve belirsiz kalan sınırları (limitations) raporla; ardından eşdeğer TypeScript testini yaz.
# 3. Android APK İmza (v1-v3.1) ve Ağ Uç Noktası Denetimi
REA ile /mutlak/yol/uygulama.apk dosyasının sertifika zincirini (inspect_apk_signature)
ve JADX üzerinden dışarıya açılan HTTPS/gRPC istemci sınıflarını çıkar.
# 4. Kaydedilmiş HAR Oturumundan Deterministik AgentEnv (RL) Ortamı Üretimi
REA kullanarak ./oturum.har kaydından ./test-env klasörüne çalıştırılabilir bir AgentEnv
ortamı oluştur; hangi API işlemlerinin doğrulandığını ve nasıl test edileceğini özetle.

7. Sık Karşılaşılan Kurulum Hataları ve Sorun Giderme (rea doctor)

Sahada rea doctor --json çıktısında en sık karşılaşılan dört yapılandırma engeli ve kök çözümleri şunlardır:

  • macOS Hopper İlk Çalıştırma Penceresi Kilidi: macOS üzerinde Hopper ilk kez açıldığında lisans veya demo modu seçimi isteyen grafiksel bir onay penceresi çıkarır. Otomatik MCP görevlerinden önce Hopper'ı aynı kullanıcı oturumunda bir kez manuel açıp bu pencereyi onaylayın.
  • Linux procps Süreç Sahipliği Hatası: Minimal Docker konteynerlerinde veya kırpılmış Linux dağıtımlarında ps komutu busybox tabanlıysa Ghidra, JADX ve statik Electron işçileri süreç sahipliği kontrolünde durur; apt install procps ile tam uyumlu ps paketini yükleyin.
  • Büyük İkili Dosyalarda Başlatma Zaman Aşımı: Yüzlerce megabaytlık C++, Rust veya Unity ikililerinde ilk sembol indekslemesi varsayılan süreyi aşabilir. Ortam değişkeni olarak REA_GHIDRA_STARTUP_TIMEOUT_MS=300000 veya REA_HOPPER_STARTUP_TIMEOUT_MS=180000 tanımlayarak süreyi uzatın.
  • Windows Üzerinde Ghidra Sağlayıcı Tanımlaması: Windows x64 ortamında tam JDK kurulumunun JAVA_HOME ile eşleştiğinden emin olun ve rea doctor --json ile sağlayıcı yolunu doğrulayın.
Kaynak Kodlu AST Analizi ile REA İkili Analizi Arasındaki Fark

Kaynak koduna zaten sahip olduğunuz projelerde mimari bağımlılıkları taramak için deterministik AST bilgi grafikleri çok daha düşük maliyetlidir; REA ise kaynak kodunun bulunmadığı derlenmiş ikili dosyalar, üçüncü parti .asar paketleri ve üretim sızıntı denetimleri için tasarlanmıştır. Sitenizin yapay zekâ yanıt motorlarındaki görünürlüğünü ölçmek için AI ve GEO Arama Denetimi aracımızı kullanabilirsiniz.


8. Kurumsal Güvenlik ve Savunma Mimarisi: İstemci Tarafı Kodunuz Artık Şeffaf

REA gibi ajan destekli analiz çerçevelerinin yükselişi, hem aracı kullanan geliştiriciler hem de ticari yazılım üreten kurumlar için kritik güvenlik sorumlulukları doğurur.

Tedarik Zinciri, Lisans ve Veri Gizliliği Uyarısı
  • Taklit Depolara Karşı Resmi Kaynak Kontrolü: Popüler tersine mühendislik araçlarının isimlerini taklit eden zararlı paketlere karşı kurulumu yalnızca resmi github.com/morluto/rea, rea.tools ve npm üzerindeki rea-agents paketinden yapın.
  • Yerel Analiz vs. Model Sağlayıcı Politikası: REA ikili dosyalarınızı kendi sunucularına yüklemez; tüm analiz yerel makinede çalışır. Ancak MCP araçlarının döndürdüğü sözde kod ve dizgiler bağlı olduğunuz yapay zekâ model sağlayıcısına iletilir; hassas kurumsal ikililerde veri saklama politikası kısıtlı kurumsal uç noktalar kullanılmalıdır.
  • Ticari Lisans ve Yasal Kapsam: IDA Pro, Hopper ve JEB gibi ticari motorlar geçerli kullanıcı lisansı gerektirir; REA yalnızca yasal birlikte çalışabilirlik, güvenlik araştırması ve yetkili olunan yazılımların analizi içindir.
İstemci Tarafı Paket Maruziyeti ve Sıfır Güven Sunucu Savunması
Şekil 2: Şeffaf istemci paketlerinin ajan tabanlı taramaya açıklığı (solda) ile kritik iş mantığını sunucu katmanında izole eden Sıfır Güven mimarisi (sağda).

Yazılım Üreticileri ve CTO'lar İçin 3 Savunma Kuralı

Bir geliştiricinin tek bir npx rea-agents komutuyla Electron paketinizi, mobil APK dosyanızı veya istemci JavaScript yığınınızı dakikalar içinde haritalandırabildiği bir ortamda "karmaşıklaştırma yoluyla güvenlik" (security through obscurity) tamamen geçerliliğini yitirmiştir:

  1. Üretim Paketlerinde Sıfır Source Map ve Anahtar Kuralı: CI/CD boru hattınızda source map dosyalarını genel dağıtımdan ayırın; üçüncü parti API anahtarlarını veya gizli yönlendirme kurallarını asla istemci paketine gömmeyin.
  2. Sıfır Güven (Zero-Trust) IPC ve API Doğrulaması: Electron contextBridge / ipcMain işleyicilerinde ve web API uç noktalarında istemciden gelen her parametreyi şema doğrulamasından geçirin; yetki kontrolünü arayüzde değil sunucu çekirdeğinde uygulayın.
  3. Ticari Algoritmaların Sunucu Tarafı İzolasyonu: Fiyatlandırma motorları, kredi/risk skorlama algoritmaları ve çok kiracılı veri filtreleri istemci ikilisinde değil, yüksek güvenlikli arka uç mikroservislerinde çalıştırılmalıdır.
Kurumsal Mimari Denetim ve Güvenli Sistem Tasarımı

Mevcut masaüstü/web uygulamalarınızın istemci sızıntı yüzeyini kapatmak, Sıfır Güven API sınırları kurgulamak veya kurum içi güvenli MCP ajan iş akışları inşa etmek için proje maliyet hesaplayıcı aracımızla kapsam oluşturabilir ya da doğrudan Kling Digital mühendislik ekibiyle iletişime geçebilirsiniz.

Sıkça Sorulan Sorular

Rehber ve entegrasyonla ilgili en sık sorulan sorular.

Tüm Yazılara Dön
Paylaş

Yorumlar (0)

Görüş ve deneyimlerinizi toplulukla paylaşın.

Henüz yorum yapılmamış. İlk yorumu siz yapın!

Yorum Bırak

Yorumunuz yönetici onayından sonra yayına alınacaktır.

Topical Authority & İç Bağlantı Ekosistemi

İlgili Mimari Kıyaslamalar, Rehberler & Dijital Araçlar

Projeniz için en doğru teknoloji kararını vermeniz adına hazırladığımız kıyaslama matrisleri, derinlemesine B2B rehberler ve canlı hesaplama araçları.

Teknik Kıyaslama

Next.js vs WordPress Kıyaslaması

Sub-second açılış hızları, sıfır eklenti açığı ve TCO analizi.

Kapsamlı Kıyaslamayı İnceleyin
Mimari Kıyaslama

Framer vs Next.js Karşılaştırması

Görsel tasarım araçları ile tam teşekküllü kurumsal web yazılımı farkları.

Kapsamlı Kıyaslamayı İnceleyin