How nocoolusername/volatility-mcp works
volatility-mcp is a local stdio MCP server that brokers queries to a separately installed Volatility 3 analyzer. Its main workflow is image discovery, plugin selection and analysis, durable run capture, then bounded reading or querying of saved results. Optional branches provide symbol provisioning, CryptoMem/add-on analysis, coverage and reports, and a local Workbench. The source index supports several internal dependency links; unsampled modules are represented by their exact paths, and uncertain wiring is omitted.
Main entry points: backend.py Analysis backend · cli.py Operator CLI · execution.py Subprocess execution · server.py Stdio MCP server
Components 26
Client interface
- Stdio MCP server
src/volatility_mcp/server.py - Operator CLI
src/volatility_mcp/cli.py - Local configuration
src/volatility_mcp/config.py
Memory analysis
- Analysis backend
src/volatility_mcp/backend.py - Plugin discovery
src/volatility_mcp/addons.py - Batch analysis
src/volatility_mcp/addon_batch.py - Sensitive-data scans
src/volatility_mcp/addon_sensitive.py - Go runtime analysis
src/volatility_mcp/addon_go.py - Python runtime analysis
src/volatility_mcp/addon_python_runtime.py - BitLocker analysis
src/volatility_mcp/addon_bitlocker.py - Keyring analysis
src/volatility_mcp/addon_keyring.py
Evidence and results
- Memory acquisitions
- Subprocess execution
src/volatility_mcp/execution.py - Saved run artifacts
- Saved-result queries
src/volatility_mcp/saved_evidence.py - Artifact inspection
src/volatility_mcp/artifact_inspection.py - Verified run reuse
src/volatility_mcp/reuse.py
Symbol provisioning
- Official symbol packs
src/volatility_mcp/symbol_packs.py - Linux symbol catalog
src/volatility_mcp/linux_symbols.py - Local symbol store
Investigation and UI
- Coverage tracking
src/volatility_mcp/coverage.py - Report validation
src/volatility_mcp/reporting.py - Local Workbench
src/volatility_mcp/ui
Other components
- MCP client
- Volatility 3
- Official download host
Connections 30
- MCP client → Stdio MCP server: calls tools
README.md - Stdio MCP server → Analysis backend: invokes operations
src/volatility_mcp/server.py - Operator CLI → Local configuration: loads settings
src/volatility_mcp/cli.py - Stdio MCP server → Local configuration: loads settings
src/volatility_mcp/server.py - Analysis backend → Local configuration: uses settings
src/volatility_mcp/backend.py - Analysis backend → Subprocess execution: runs commands
src/volatility_mcp/backend.py - Analysis backend → Verified run reuse: checks prior runs
src/volatility_mcp/backend.py - Analysis backend → Saved-result queries: queries saved evidence
src/volatility_mcp/backend.py - Analysis backend → Artifact inspection: inspects artifacts
src/volatility_mcp/backend.py - Analysis backend → Coverage tracking: projects evidence
src/volatility_mcp/backend.py - Subprocess execution → Volatility 3: runs analyzer
README.md - Subprocess execution → Memory acquisitions: reads images
README.md - Subprocess execution → Saved run artifacts: saves outputs
README.md - Analysis backend → Plugin discovery: discovers plugins
src/volatility_mcp/addons.py - Operator CLI → Plugin discovery: configures plugins
src/volatility_mcp/addons.py - Sensitive-data scans → Batch analysis: reuses scanning
src/volatility_mcp/addon_sensitive.py - Saved-result queries → Saved run artifacts: reads artifacts
src/volatility_mcp/saved_evidence.py - Artifact inspection → Saved run artifacts: reads artifacts
src/volatility_mcp/artifact_inspection.py - Verified run reuse → Saved run artifacts: checks run records
src/volatility_mcp/reuse.py - Coverage tracking → Saved run artifacts: projects saved runs
src/volatility_mcp/coverage.py - Report validation → Coverage tracking: validates provenance
src/volatility_mcp/reporting.py - Report validation → Saved run artifacts: checks artifacts
src/volatility_mcp/reporting.py - Operator CLI → Report validation: validates reports
src/volatility_mcp/cli.py - MCP client → Local Workbench: uses optionally
README.md - Operator CLI → Official symbol packs: installs packs
src/volatility_mcp/cli.py - Operator CLI → Linux symbol catalog: manages Linux symbols
src/volatility_mcp/cli.py - Official symbol packs → Local symbol store: provisions tables
src/volatility_mcp/symbol_packs.py - Linux symbol catalog → Local symbol store: installs tables
src/volatility_mcp/linux_symbols.py - Official symbol packs → Official download host: downloads from
src/volatility_mcp/symbol_packs.py - Linux symbol catalog → Official download host: downloads from
src/volatility_mcp/linux_symbols.py