dfir-mcp
Parses the Chromium-format 'History' SQLite database from Brave (as well as Chrome/Edge) profiles, read-only, returning browsing visits and downloads that can be filtered or merged into a UTC-ordered forensic timeline.
Parses Firefox's 'places.sqlite' browsing-history database read-only, returning visits that can be queried or included in a combined forensic timeline alongside event logs and registry artifacts.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
dfir-mcp
Digital forensics for AI agents. An MCP server (and a plain CLI) that parses Windows event logs, registry hives and browser history read-only, and attaches a file hash and a list of limitations to every result.
Example session, using the sample log in tests/data:
You: What happened on this machine around the time the new account appeared?
Agent: → file_info(security.evtx) sha256 5f29a03c…
→ evtx_summary(security.evtx) 2,261 records, two 4720 "User account created"
→ evtx_query(event_ids=[4720, 4732])
→ build_timeline([security.evtx, History])Why
A general-purpose AI agent cannot read an .evtx file or an offline registry hive, and when it guesses it gives no way to check the answer. dfir-mcp gives the agent real parsers and makes each answer traceable:
evidenceblock on every result: path, size, SHA-256, parser and tool version, examination time.limitationson every result: what the artifact cannot prove (cleared logs, per-key timestamps, unmerged WAL files).Evidence is never written to. SQLite databases are opened
mode=ro&immutable=1; hives and logs are opened for reading only. A test checks that bytes, mtime and the surrounding folder are unchanged after parsing.
Related MCP server: Self-Assembling Forensic MCP Server
Tools
Tool | Artifact | What it returns |
| any file | MD5, SHA-1, SHA-256, detected type, which tool to use next |
| Windows | record count, time span, channels, count per event ID, notable IDs called out |
| Windows | records filtered by event ID, UTC window and text, with paging |
| Chrome/Edge/Brave | visits and (Chromium) downloads |
| offline hive | values, subkeys and last-written time of one key |
|
| Run, RunOnce and Winlogon autostart entries |
| several of the above | one UTC-ordered timeline, optional CSV, each row tagged with its source hash |
Install
pip install git+https://github.com/ravirajsinhpadhiar/dfir-mcpPython 3.10 or newer.
Connect an agent
Claude Code:
claude mcp add dfir -- dfir-mcp serveAny MCP client:
{
"mcpServers": {
"dfir": {
"command": "dfir-mcp",
"args": ["serve"],
"env": { "DFIR_MCP_ROOT": "/cases/2026-014" }
}
}
}DFIR_MCP_ROOT is optional but recommended: when set, the server refuses to read anything outside that folder.
Use without an agent
dfir-mcp info security.evtx
dfir-mcp evtx-summary security.evtx
dfir-mcp evtx-query security.evtx --id 4624 --id 4625 --start 2016-07-08T18:00:00Z --limit 20
dfir-mcp browser History --contains download
dfir-mcp autoruns NTUSER.DAT
dfir-mcp reg-key NTUSER.DAT 'Software\Microsoft\Windows\CurrentVersion\Run'
dfir-mcp timeline security.evtx History --csv timeline.csvWorking practice
Work on forensic copies, not originals, and keep your own chain-of-custody record. The hashes this tool reports identify the file it read; they do not replace acquisition hashes taken with a write blocker.
Limits
Coverage is deliberately narrow in 0.1. Not yet parsed: Prefetch, Amcache, ShimCache, SRUM,
$MFT, LNK files, jump lists, Linux and macOS artifacts.Registry transaction logs (
.LOG1,.LOG2) are not replayed.Browser databases are read without their
-walfile, so the most recent activity may be missing.Deleted records are not carved.
EVTX parsing is pure Python: roughly 200 to 300 records per second, so very large logs take minutes.
Autoruns covers registry Run-style keys only, not services, scheduled tasks or WMI persistence.
Develop
git clone https://github.com/ravirajsinhpadhiar/dfir-mcp && cd dfir-mcp
pip install -e ".[dev]"
pytestEVTX and registry tests run against real public sample artifacts; see tests/data/README.md for their origin.
Credits
Built on python-evtx and regipy.
Licence
MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only finance and operations controls for AI agents with evidence and safe next actions.
Artifact store for AI agents — read, write, and search files by path; share by rendered URL.
Read-only tools over the Safer Agentic AI framework: 239 patterns + 15 heuristics.
Trust signals for AI agents: an open agent-readiness standard and developer tool guide. Read-only.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables AI-assisted Windows digital forensics analysis including parsing Windows Event Logs (EVTX), analyzing registry hives (SAM, SYSTEM, SOFTWARE), and remotely collecting artifacts via WinRM with built-in security queries and forensic reference data.5527MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform digital forensics analysis including memory analysis, file metadata inspection, and threat-intelligence lookups.8 npmISC
- FlicenseAqualityDmaintenanceEnables AI agents to perform digital forensics and incident response tasks by dynamically discovering and utilizing host tools for memory analysis, metadata extraction, threat detection, and file dissection.51-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to inspect Autopsy forensic cases through read-only MCP tools for case metadata, filesystem and artifact search, timeline and account queries, evidence extraction, and hash-chained audit/seal verification.2GPL 3.0