How mwemuorg/mwemu works
MWEmu is a hardware emulator and OS process simulator aimed at malware analysis. Its central workflow is to load a PE, ELF, or shellcode image, configure an emulated architecture and process, execute instructions while simulating OS services, then inspect or trace the resulting state. Users can access the runtime through the CLI, Rust library, Python/C bindings, or an MCP server. The graph preserves documented execution, debugging, exception, and platform capabilities; many internal links are omitted because their implementation paths were not sampled.
Main entry points: mod.rs Instruction execution · emu_context.rs Emulator context · loaders.rs Image loading · main.rs CLI
Components 20
User interfaces
- CLI
crates/mwemu/src/main.rs - Rust API
crates/libmwemu/src/lib.rs - Python binding
crates/pymwemu/src/lib.rs - C binding
crates/cmwemu/src/lib.rs - MCP server
crates/mwemu-mcp/src/server.rs - MCP tools
crates/mwemu-mcp/src/tools.rs
Emulation runtime
- Image loading
crates/libmwemu/src/emu/loaders.rs - Emulator context
crates/libmwemu/src/emu/emu_context.rs - Instruction execution
crates/libmwemu/src/emu/execution/mod.rs - Instruction engine
crates/libmwemu/src/engine/mod.rs - Virtual memory
crates/libmwemu/src/emu/memory.rs
OS simulation
- OS API simulation
crates/libmwemu/src/api/windows/export_index.rs - Linux syscalls
crates/libmwemu/src/api/linux/libc.rs - Exception handling
crates/libmwemu/src/emu/exception_handlers.rs
Analysis and state
- Interactive debugger
crates/libmwemu/src/debug/console.rs - State tracking
crates/libmwemu/src/emu/trace.rs - Process snapshots
crates/mwemu-snapshot/src/linux.rs
Executable formats
- PE parsing
crates/libmwemu/libraries/rs-header/src/pe/pe32/parser.rs - ELF loading
crates/libmwemu/libraries/rs-header/src/elf/loader.rs
Other components
- Analyst
Connections 20
- Analyst → CLI: runs
README.md - CLI → Rust API: uses library
- Analyst → MCP server: connects
- MCP server → MCP tools: dispatches tools
crates/mwemu-mcp/src/server.rs - MCP tools → Emulator context: controls session
crates/mwemu-mcp/src/tools.rs - Analyst → Rust API: uses library
README.md - Analyst → Python binding: uses binding
README.md - Analyst → C binding: uses binding
README.md - Emulator context → Image loading: loads images
- Image loading → PE parsing: parses PE
- Image loading → ELF loading: loads ELF
- Emulator context → Instruction execution: runs instructions
- Instruction execution → Instruction engine: executes decoded
- Instruction execution → Virtual memory: accesses memory
- Instruction execution → OS API simulation: dispatches APIs
- Instruction execution → Linux syscalls: dispatches syscalls
- Instruction execution → Exception handling: handles faults
crates/libmwemu/src/emu/exception_handlers.rs - Analyst → Interactive debugger: inspects state
README.md - Emulator context → State tracking: tracks state
- Analyst → Process snapshots: captures state