~/projects/binary-analysis-workflow/README.md

Binary Analysis / AI-Assisted RE

status: active source: private type: reverse engineering tooling
ida promcpai agentsstatic analysispython

what it is

A reverse-engineering workflow that connects IDA Pro to AI agents through MCP (Model Context Protocol), letting agents perform mechanical analysis tasks — function triage, decompilation review, renaming, annotation — while a human directs the investigation.

problem / objective

Static analysis of a binary is mostly repetitive work: hundreds of functions to skim, obvious library code to identify and set aside, names and comments to apply so the interesting logic becomes visible. The objective was to delegate that mechanical layer to agents and spend human time on interpretation — the part that actually requires judgment.

environment

architecture / design

The MCP layer exposes IDA's analysis surface — decompile a function, list xrefs, rename symbols, apply comments — as tools an agent can call. The human operator sets the goal ("triage this binary, find the interesting logic"), the agent does passes over functions and proposes annotations, and every change is reviewable in the database.

technical implementation

security considerations / methodology

interesting problems encountered

what i built

results

Noticeably faster triage on unknown binaries — the mechanical passes that used to eat hours get delegated, and the analysis session starts at the interesting functions instead of function zero.

evidence

IDA Pro decompilation of fodhelper.exe — COM self-registration logic in pseudocode view
$ ida pro, pseudocode view — fodhelper.exe (a signed auto-elevated Windows binary) decompiled; COM self-registration logic visible in the listing
IDA Pro pseudocode of WinMainWorker with [agent] comments applied via MCP
$ agent annotation pass over the MCP session — comments applied programmatically on WinMainWorker, including the auto-elevated ShellExecuteExW launch and the HKCU ms-settings / DelegateExecute resolution path
Workflow configuration and analysis targets stay private. This writeup describes the methodology; no binaries or proprietary artifacts are published.

what i learned / next steps

Where AI assistance actually helps in RE (mechanical passes, naming, summarization) and where it doesn't (novel logic, attacker intent — still human work). Next: tightening the verification pass and extending coverage to more analysis tasks.