Skip to content
Back to search

Arkana

Arkana - Your entire malware analysis lab, behind one AI prompt. 250+ MCP tools for binary analysis with Claude Code or other MCP

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/jamezuk--arkana/badge.svg)](/listings/jamezuk--arkana)

HTML

<a href="/listings/jamezuk--arkana"><img src="/api/listings/jamezuk--arkana/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 246 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Arkana - Your Entire Malware Analysis Lab, Behind One AI Prompt
  2. ![Arkana Logo](docs/assets/logo_banner.svg)
  3. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  4. [![CI](https://github.com/JameZUK/Arkana/actions/workflows/ci.yml/badge.svg)](https://github.com/JameZUK/Arkana/actions/workflows/ci.yml)
  5. [![Python 3.10+](https://img.shields.io/badge/Python-3.10+-green.svg)](https://www.python.org/)
  6. [![MCP Tools](https://img.shields.io/badge/MCP_Tools-308-purple.svg)](docs/tools-reference.md)
  7. [![GitHub stars](https://img.shields.io/github/stars/JameZUK/Arkana?style=social)](https://github.com/JameZUK/Arkana)
  8. [![MCPVault: claimed](https://mcpvault.io/badge/arkana.svg?theme=dark)](https://mcpvault.io/servers/arkana/health?utm_source=external_badge&utm_medium=referral&utm_campaign=mcp_health_report)
  9. > *"Analyse asyncrat.exe and tell me what it does"*
  10. From a single prompt, Arkana opens the binary, triages it (CRITICAL -- 43/72 VT detections),
  11. extracts the C2 server (`cveutb.sa.com`), identifies AES-256 encrypted communications via
  12. MessagePack, maps 12 MITRE ATT&CK techniques, detects anti-VM checks for VMware/VirtualBox/
  13. Sandboxie, finds the persistence mechanism (Registry Run key), and recovers the operator's
  14. PDB path revealing a Vietnamese-speaking threat actor.
  15. [See the full report.](docs/examples/example-report-asyncrat.md)
  16. > *"Step through the unpacking stub and show me what it decrypts"*
  17. Arkana starts an interactive debug session, sets breakpoints on `VirtualAlloc` and `VirtualProtect`, steps through the decryption loop, snapshots state before and after, diffs the memory regions, and dumps the unpacked payload -- all driven by natural language.
  18. ![Arkana analysing AsyncRAT](docs/demos/demo-asyncrat.gif)
  19. Arkana is a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server that gives **Claude Code** (or any MCP client) **308 analysis tools** -- decompilation, symbolic execution, interactive step-through debugging, data-flow analysis, YARA/capa/FLOSS signatures, Binary Refinery data transforms, Qiling/Speakeasy emulation, .NET deobfuscation, function similarity matching, and a real-time web dashboard -- so you can investigate PE, ELF, Mach-O, .NET, Go, Rust, and shellcode samples by describing what you want to know. No Ghidra scripts, no CLI flags, no context-switching between a dozen tools. Just results.
  20. ---
  21. ## Why Arkana
  22. **The problem:** Malware analysis means juggling Ghidra, IDA, CyberChef, YARA, and a dozen other tools -- each with its own interface, scripting language, and learning curve. Investigating a single sample might mean switching between 5-10 tools, manually correlating findings across disconnected workflows.
  23. Arkana eliminates this by putting **308 specialised analysis tools behind a single AI-driven interface** -- the equivalent of an entire malware lab in one MCP server. Describe what you want to know in natural language and the AI orchestrates the right tools automatically.
  24. **What makes it different:**
  25. - **Breadth** -- 308 tools spanning PE/ELF/Mach-O parsing, angr-powered decompilation and symbolic execution, Binary Refinery's 200+ composable data transforms, YARA/capa/FLOSS/PEiD signature engines, Qiling/Speakeasy emulation, .NET/Go/Rust specialised analysis, .NET deobfuscation and C# decompilation, Frida script generation, vulnerability pattern detection, cross-binary function similarity search, and VirusTotal integration.
  26. - **AI reasoning over results** -- Unlike tools that just produce output, Arkana feeds results back to an AI that can reason about them. When it decompiles a function and sees `VirtualAlloc` followed by `memcpy` and an indirect call, it recognises the shellcode injection pattern, renames the function to `inject_shellcode`, and suggests investigating the source buffer.
  27. - **Zero-config auto-enrichment** -- Open a file and Arkana immediately begins background classification, risk scoring, MITRE ATT&CK mapping, IOC extraction, library identification, and a decompilation sweep. By the time you ask your first question, the answers are already cached.
  28. - **Interactive debugging** -- Step through binaries instruction-by-instruction with breakpoints, watchpoints, memory inspection, execution snapshots, API call tracing, I/O capture, and custom API stubs. Explore alternative execution paths by snapshotting state, modifying registers or memory, and comparing outcomes.
  29. - **Session continuity** -- Notes, function renames, custom type definitions, and tool history survive context window limits and server restarts, enabling investigations that span hours or days without losing context.
  30. - **Real-time web dashboard** -- A visual companion that updates live as the AI works: function triage with XREF analysis, interactive call graph, strings explorer, MITRE ATT&CK matrix, hex viewer, and analysis timeline. Analyst flags set on the dashboard feed directly back into the AI's tool suggestions.
  31. **Who benefits:**
  32. - **SOC analysts** -- automated triage with risk scoring, MITRE mapping, and IOC extraction in seconds; web dashboard for visual review
  33. - **Malware reversers** -- natural language drives decompilation, symbolic execution, interactive debugging, and data transforms across multi-stage payloads
  34. - **Incident responders** -- rapid C2 config extraction, network indicators, and structured reports under time pressure
  35. - **Learners** -- built-in interactive RE tutor with Socratic guidance, progress tracking, and hands-on exercises using real tools
  36. - **Threat intel teams** -- automated similarity hashing, family identification, YARA rule generation, and cross-binary function matching
  37. ---
  38. ## Key Features
  39. - **Multi-format support** -- PE, ELF, Mach-O, .NET, Go, Rust, and raw shellcode with auto-detection and pre-parse integrity checks (truncation, corruption, null-padding detection). Unknown formats (ZIP, PDF, PCAP) fall back to raw mode with clear guidance instead of crashing. LIEF serves as a fallback parser when pefile cannot handle malformed PEs.
  40. - **Angr-powered analysis** -- 46 tools for decompilation, batch decompilation, CFG, symbolic execution, data-flow, slicing, and emulation
  41. - **Comprehensive static analysis** -- 27 PE structure tools, YARA/capa/PEiD/FLOSS signatures, crypto detection, hex pattern search, IOC export
  42. - **Binary Refinery integration** -- 23 context-efficient tools wrapping 200+ composable data transforms (encoding, crypto, compression, forensics)
  43. - **Cross-platform emulation** -- Speakeasy (Windows APIs) and Qiling (Windows/Linux/macOS, x86/x64/ARM/MIPS)
  44. - **Interactive debugger** -- 29 tools for step-through emulation with breakpoints, watchpoints, memory inspection, snapshots, API call tracing, I/O capture, custom API stubs, and memory search -- up to 3 concurrent debug sessions
  45. - **Function similarity (BSim-style)** -- Architecture-independent function matching across binaries using 8 feature groups (CFG, API calls, VEX IR, strings, constants, size, block hashes, call context). Auto-indexes every binary during enrichment; renames sync to the BSim DB so `transfer_annotations` carries your analysis to variants. Includes whole-binary triage, confidence scoring, and false-positive guards
  46. - **Interactive annotation** -- Rename functions and variables, define custom structs/enums, add address labels -- all persisted across sessions and applied automatically in decompilation output
  47. - **Session persistence** -- Notes, renames, custom types, tool history, and analysis cache survive restarts and context window limits
  48. - **Auto-enrichment** -- Opening a file automatically triggers background classification, triage, MITRE mapping, IOC collection, library identification, and a decompilation sweep -- results are ready before you ask
  49. - **AI-optimised workflow** -- Compact triage, smart function ranking, batch decompilation, digest summaries, and guided next steps
  50. - **Robust architecture** -- Docker-first, thread-safe state, background tasks, pagination, smart truncation, graceful degradation
  51. - **Brief descriptions** -- `--brief-descriptions` trims tool descriptions to first-paragraph summaries, reducing tool listing size by ~60% for clients without tool search
  52. - **Web dashboard** -- Real-time CRT-themed web interface on port 8082 with binary summary, function triage with XREF analysis panel, dagre-layout call graph with tabbed sidebar, analysis timeline, strings explorer, and notes browser -- analyst flags feed back into AI tool suggestions
  53. ### How It Compares
  54. | | Arkana | Ghidra | IDA Pro | CyberChef |
  55. |---|---|---|---|---|
  56. | **AI reasoning** | Native | No | No | No |
  57. | **Decompilation** | Angr (multi-arch, batch) | Ghidra Decompiler | Hex-Rays ($$$) | No |
  58. | **Function similarity** | BSim-style cross-binary | BSim (Java) | BinDiff/Lumina | No |
  59. | **Data transforms** | 200+ via Refinery | Manual scripting | Manual scripting | 300+ (manual) |
  60. | **Emulation** | Speakeasy + Qiling | Limited | No | No |
  61. | **Interactive debugging** | 29-tool step debugger | Manual | Manual | No |
  62. | **Auto-enrichment** | Background triage on open | No | No | No |
  63. | **Web dashboard** | Real-time, 14 pages | No | No | No |
  64. | **Learning curve** | Natural language | Months | Months | Moderate |
  65. | **Cost** | Free & open source | Free | $1,800+/yr | Free |
  66. Arkana complements rather than replaces Ghidra/IDA -- see [Scenarios & Comparisons](docs/examples/scenarios.md) for detailed analysis.
  67. ### Web Dashboard
  68. Arkana includes a real-time web dashboard that launches automatically on port 8082. It provides a visual companion to the AI-driven analysis, letting you observe and interact with the investigation as it happens.
  69. - **Overview** -- Binary summary with risk score, packing status, security mitigations, key findings with function pivot links, and recent notes
  70. - **Functions** -- Sortable function explorer with triage buttons (FLAG / SUS / CLN), XREF analysis panel, inline notes, full-text code search, and symbol tree view -- click XREF to see cross-references with suspicious API badges, clickable callers/callees that navigate to the target function, and associated strings, all without requiring decompilation first
  71. - **Call Graph** -- Interactive Cytoscape.js call graph with dagre hierarchical layout, tabbed sidebar (INFO / XREFS / STRINGS / CODE) on node selection, enrichment score-based border thickness, neighbourhood highlighting with marching-ant edges, search, bookmarks, and PNG/SVG export
  72. - **Sections** -- PE/ELF section permissions with anomaly highlighting (W+X detection) and entropy heatmap
  73. - **Imports** -- DLL import tables with export/function grouping and clickable export addresses
  74. - **Hex View** -- Infinite-scroll hex dump with jump-to-offset navigation
  75. - **Strings** -- Unified string explorer with FLOSS detail panel (type breakdown, decoded/stack string preview), type/category filtering, sifter scores, and function column with links
  76. - **CAPA** -- Capability matches grouped by namespace with function links
  77. - **MITRE** -- ATT&CK technique matrix with IOC panel
  78. - **Types** -- Custom struct/enum type editor for binary data parsing
  79. - **Similarity** -- BSim triage (whole-binary similarity against signature DB), BinDiff function-level comparison, and signature database management
  80. - **Timeline** -- Chronological log of every tool call and note, with expandable detail panels showing request parameters and result summaries
  81. - **Notes** -- Category-filtered view of all analysis notes (general, function, tool_result, IOC, hypothesis, conclusion, manual) with clickable address links
  82. - **Global status bar** -- Active tool and background task progress visible from every page
  83. - **Real-time updates** -- SSE-driven live refresh as the AI runs tools
  84. ![Arkana Dashboard Overview](docs/screenshots/Arkana%20%E2%80%94%20Overview.png)
  85. The dashboard uses token-based authentication (persisted to `~/.arkana/dashboard_token`). Access URL with token is printed at server startup. See the [Dashboard Gallery](docs/dashboard.md) for screenshots of all views.
  86. ---
  87. ## Example Reports
  88. Every report below was generated from a single prompt: *"Analyse this binary and tell me what it does."*
  89. | Report | Sample | Highlights |
  90. |--------|--------|-----------|
  91. | [Trojan.Delshad BYOVD Loader](docs/examples/example-report.md) | Multi-stage dropper | Payload carving, attack chain diagram, 12 ATT&CK techniques |
  92. | [LockBit 3.0 Ransomware](docs/examples/example-report-lockbit.md) | Packed ransomware | Entropy analysis, packing detection, stub extraction |
  93. | [AsyncRAT .NET RAT](docs/examples/example-report-asyncrat.md) | .NET RAT | C2 config extraction despite obfuscated metadata |
  94. | [StealC Info Stealer](docs/examples/example-report-stealc.md) | Credential stealer | 32 capa rules, browser/Steam targeting, crypto toolkit |
  95. | [ValleyRAT Multi-Stage Loader](docs/examples/example-report-valleyrat.md) | Chinese APT RAT | 5-stage unpacking, custom ARX cipher reversal, C2 config extraction |
  96. | [Brute Ratel C4 Badger](docs/examples/example-report-bruteratel.md) | Commercial C2 implant | PIC shellcode tracing, RC4 unpacking, C2 config extraction, 17 ATT&CK techniques |
  97. | [CrackMeZ3S CTF Challenge](docs/examples/example-report-crackme-z3s.md) | PELock 6-key crackme | Interactive debugger with IAT patching, code-cave shellcode injection, encrypted blob decryption, manual XOR cipher reversal, MD5 hash cracking |
  98. | [Ternary Trap Neural Crackme](docs/examples/example-report-ternary-trap.md) | Neural network password lock | Custom NLI2 format reversal, ternary MLP reconstruction, SIMD assembly type discovery (cvtdq2pd), autoregressive inference, DFS password search |
  99. | [ACRStealer Go Loader](docs/examples/example-report-acrstealer.md) | Go-compiled info stealer | Same-day Malware Bazaar sample, Go pclntab parsing, custom 5-stage cipher reversal, PEB-walking API evasion, zero static IOCs, encrypted payload extraction |
  100. | [SalatStealer 3-Layer Stealer](docs/examples/example-report-salatstealer.md) | 3-layer Go stealer | AES-256-CBC payload decryption, UPX 5.02 LZMA manual decompression, Go module mapping, 16 browsers + 23 wallets + LSASS dump, dual Defender evasion, DoH C2 |
  101. | [StealC v2 7-Layer AutoIt3 Loader](docs/examples/example-report-stealc-autoit.md) | 7-layer process hollowing loader | IExpress SFX → batch deobfuscation → PE fragment reassembly → RanRot PRNG decryption → 41-API process hollowing → RC4 + LZNT1 payload extraction → StealC v2 PE with encrypted C2 config, builder path, and credential targets |
  102. | [Elysium RAT (SheetRAT)](docs/examples/example-report-elysium-rat.md) | .NET plugin-based RAT | Same-day MalwareBazaar sample, custom 2-alphabet substitution cipher, 313 C# files recovered, AMSI/ETW patch bytes extracted, plugin-framework architecture with registry DLL storage, dual C2 with Dead Drop Resolver |
  103. | [CrySome RAT](docs/examples/example-report-crysome-rat.md) | .NET modular RAT | 124 C# files decompiled, 5-layer persistence with factory reset survival, BSOD-on-kill self-protection, 5-vector AV killer targeting 114+ products, HVNC for 6 browsers, DLL-injection credential theft, mutual watchdog processes |
  104. | [MBA-Obfuscated WinHTTP RAT](docs/examples/example-report-malbazaar-rat.md) | Same-day Malware Bazaar RAT | Full C2 protocol reversal (4 commands, versioned protocol, Cloudflare bypass), Mixed Boolean-Arithmetic obfuscation hiding XOR crypto, Base64+XOR encrypted C2, download-and-execute (EXE/DLL/custom), 27 anti-analysis techniques, embedded Chromium form injection, system profiling with author misspelling fingerprint |
  105. ---
  106. ## How Analysis Works
  107. Arkana follows a structured, evidence-first methodology -- the same phased workflow a professional malware analyst uses, orchestrated automatically across 308 tools. Every claim cites specific tool output, indicators are treated as leads (not conclusions), and the AI cannot attempt decryption without first decompiling the function that performs it.
  108. **[Read the full methodology with annotated AsyncRAT walkthrough →](docs/methodology.md)**
  109. ---
  110. ## Get Started in 4 Commands
  111. Arkana works with **Claude Code** and any MCP-compatible client. The fastest way to get running with Claude Code and Docker:
  112. ```bash
  113. # 1. Clone and build (first build takes a few minutes)
  114. git clone https://github.com/JameZUK/Arkana.git
  115. cd Arkana
  116. ./run.sh --build
  117. # 2. Add Arkana to Claude Code
  118. claude mcp add --scope project arkana -- ./run.sh --samples ~/your-samples --stdio
  119. # Optional: reduce context window usage with shorter tool descriptions
  120. claude mcp add --scope project arkana -- ./run.sh --samples ~/your-samples --stdio --brief-descriptions
  121. # 3. Start Claude Code and analyse a binary
  122. claude
  123. ```
  124. Then in Claude Code, use the `/arkana-analyse` skill to get the best results:
  125. ```
  126. > /arkana-analyse suspicious.exe
  127. ```
  128. Or just ask a question directly:
  129. ```
  130. > Open suspicious.exe and tell me if it's malicious
  131. ```
  132. There's also an `/arkana-learn` skill -- an interactive reverse engineering tutor that teaches you binary analysis hands-on using Arkana's tools.
  133. For other MCP clients, local Python installation, and detailed configuration, see the [Installation Guide](docs/installation.md).
  134. ---
  135. ## Demos
  136. **AsyncRAT analysis** -- single prompt to full triage, C2 extraction, and MITRE ATT&CK mapping:
  137. ![Arkana analysing AsyncRAT](docs/demos/demo-asyncrat.gif)
  138. <sub>Interactive playback: `asciinema play docs/demos/demo-asyncrat.cast`</sub>
  139. **Multi-phase investigation** -- deep analysis with decompilation, emulation, and structured findings:
  140. ![Arkana deep analysis](docs/demos/demo-analysis.gif)
  141. <sub>Interactive playback: `asciinema play docs/demos/demo-analysis.cast`</sub>
  142. ---
  143. ## Documentation
  144. | Document | Description |
  145. |----------|-------------|
  146. | **[Installation Guide](docs/installation.md)** | Docker, local, and minimal installation; modes of operation; multi-format binary support |
  147. | **[Analysis Methodology](docs/methodology.md)** | Eight-phase analysis pipeline, tool-by-tool walkthrough, decision logic, built-in guardrails, annotated AsyncRAT example |
  148. | **[Claude Code Integration](docs/claude-code.md)** | Setup via CLI and JSON config; analysis and learning skills; typical workflows and example queries |
  149. | **[Configuration](docs/configuration.md)** | API keys, analysis cache, and command-line options |
  150. | **[Tools Reference](docs/tools-reference.md)** | Complete catalog of all 308 MCP tools organised by category |
  151. | **[VM-Protected Binaries](docs/vm-protected-binaries.md)** | Analysing VMProtect/Themida/Enigma binaries with Frida DBI scripts; four-stage pipeline |
  152. | **[Scenarios & Comparisons](docs/examples/scenarios.md)** | Seven real-world analysis walkthroughs; Arkana vs Ghidra, IDA Pro, CyberChef |
  153. | **[Architecture](docs/architecture.md)** | Package structure, design principles, pagination and result limits |
  154. | **[Security & Testing](docs/security.md)** | Path sandboxing, security measures, testing and CI/CD |
  155. | **[Web Dashboard](docs/dashboard.md)** | Real-time analysis dashboard on port 8082; function triage, call graph, timeline, notes |
  156. | **[Qiling Rootfs Setup](docs/QILING_ROOTFS.md)** | Windows DLL setup for Qiling cross-platform emulation |
  157. | **[Dependencies](docs/dependencies.md)** | Library dependencies and optional component details |
  158. | **[Future Improvements](docs/future-improvements.md)** | Roadmap and planned enhancements |
  159. | **[Contributing](docs/CONTRIBUTING.md)** | Contribution guidelines and development workflow |
  160. ---
  161. ## Contributing
  162. Contributions are welcome! See the [Contributing Guide](docs/CONTRIBUTING.md) for details.
  163. 1. Fork the repository
  164. 2. Create a feature branch (`git checkout -b feature/your-enhancement`)
  165. 3. Commit your changes
  166. 4. Open a Pull Request
  167. ---
  168. ## Licence
  169. Distributed under the MIT Licence. See `LICENSE` for more information.
  170. ---
  171. ## Disclaimer
  172. This toolkit is provided "as-is" for educational and research purposes only. It is capable of executing parts of analysed binaries (via angr emulation and symbolic execution) in a sandboxed environment. Always exercise caution when analysing untrusted files. The authors accept no responsibility for misuse or damages arising from the use of this software.
  173. ---
  174. If Arkana is useful to you, consider giving it a star -- it helps others discover the project.
  175. [Report a bug](https://github.com/JameZUK/Arkana/issues) | [Request a feature](https://github.com/JameZUK/Arkana/issues) | [Full tools reference](docs/tools-reference.md)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.