Forensics MCP Server
자가 조립 포렌식 MCP 서버 (FastMCP / Python)
Python과 FastMCP (mcp>=2.0.0)로 구축된 모듈식 디지털 포렌식 및 사고 대응(DFIR) 모델 컨텍스트 프로토콜(MCP) 서버입니다.
시작 시 호스트 및 컨테이너 포렌식 유틸리티를 동적으로 발견하고, 로컬 LLM 및 AI 에이전트(Ollama, Claude, Cursor, Antigravity 등)를 위한 기능적 도구, 리소스 및 트라이어지 프롬프트를 자동으로 자가 조립합니다.
🌟 특징
🔍 동적 기능 발견: 호스트 환경 경로, 설치된 바이너리(
exiftool,strings,volatility3,binwalk,tshark,objdump,gdb,yara) 및 Docker 런타임을 탐색합니다. 누락된 도구는 충돌 없이 정상적으로 보고됩니다.🧩 자가 조립 도구 프리미티브: 호스트 환경에서 사용 가능한 도구만 자동으로 등록합니다.
🛡️ 에어 갭 및 오프라인 준비: 알려진 샘플 서명(EICAR, WannaCry, Mimikatz)이 포함된 내장 오프라인 위협 인텔리전스 데이터베이스를 통해 안전하고 데이터 유출이 없는 사고 대응을 지원합니다.
📋 변조 증거 체인 오브 커스터디: 모든 도구 실행, 검사된 아티팩트, SHA-256 체크섬 및 작업 매개변수는 암호화되어 해시 처리되고 추가 전용 원장(
evidence/chain_of_custody.jsonl)에 기록됩니다.🩺 자가 보고 상태 및 리소스: 실시간 기능 매트릭스(
forensics://capabilities), 관리 기록(forensics://custody) 및 시스템 상태(forensics://health).⚡ 이중 전송: 기본 MCP 클라이언트(Cursor, Claude, Antigravity)를 위한 표준 STDIO와 웹 LLM 에이전트(Ollama, Open WebUI)를 위한 SSE/HTTP를 지원합니다.
Related MCP server: findevil-agent
🚀 빠른 시작
1. 사전 요구 사항
Python 3.10+ (또는 uv)
2. 서버 실행
옵션 A: 네이티브 STDIO 전송 (로컬 에이전트 / Cursor / Claude용)
cd /home/b47m4n/Projects/forensics-mcp-framework
uv run src/server.py옵션 B: SSE / HTTP 전송 (웹 / 원격 LLM용)
cd /home/b47m4n/Projects/forensics-mcp-framework
uv run src/server.py --transport sse --port 8000🔌 로컬 LLM 및 에이전트에 연결
1. Antigravity / Claude / Cursor (claude_desktop_config.json / mcp.json)
{
"mcpServers": {
"forensic-analyzer": {
"command": "uv",
"args": [
"--directory",
"/home/b47m4n/Projects/forensics-mcp-framework",
"run",
"src/server.py"
]
}
}
}2. Ollama + MCP를 통한 로컬 LLM
SSE 엔드포인트를 통해 로컬 모델(예: llama3.1, qwen2.5-coder)을 연결합니다:
http://localhost:8000/sse
🛠️ 발견된 도구 카탈로그
도구 | 카테고리 | 동적 조건 | 설명 |
| 메타데이터 및 파일 | 항상 사용 가능 | 해시(MD5/SHA256), EXIF 태그 계산 및 MIME 불일치 탐지 |
| 정적 분석 | 항상 사용 가능 | 인쇄 가능한 ASCII 및 유니코드 문자열 추출 |
| 위협 탐지 | 항상 사용 가능 | C2 URL, IP 주소, Base64 블롭, 명령 실행 스캔 |
| 위협 인텔리전스 | 항상 사용 가능 | 오프라인 서명 및 선택적 실시간 API에 대한 해시 확인 |
| 진단 | 항상 사용 가능 | 상태, 스토리지 확인 및 도구 준비 상태 |
| 메모리 포렌식 |
| Volatility 3 |
| 메모리 포렌식 |
| Volatility 3 |
| 메모리 포렌식 |
| Volatility 3 |
| 메모리 포렌식 |
| Volatility 3 |
| 메모리 포렌식 |
| Volatility 3 |
| 파일 캐빙 |
| 펌웨어 서명 및 파일 시스템 캐빙 |
| 네트워크 포렌식 |
| PCAP 네트워크 패킷 캡처 분석 |
| 리버스 엔지니어링 |
| 바이너리 기계 명령어 디스어셈블 |
| 디버깅 |
| 자동화된 배치 디버깅 검사 |
| 서명 매칭 |
| YARA 규칙 파일에 대한 증거 스캔 |
📂 프로젝트 아키텍처
forensics-mcp-framework/
├── pyproject.toml
├── .env.example
├── README.md
├── evidence/ # Evidence locker & chain of custody ledger
│ ├── suspect_photo.jpg
│ ├── eicar_test.com
│ └── chain_of_custody.jsonl
└── src/
├── server.py # Master FastMCP bootstrap & dynamic assembler
├── core/
│ ├── discovery.py # Host & container capability scanner
│ ├── custody.py # Tamper-evident append-only chain of custody
│ └── health.py # System diagnostics & health reporter
├── tools/
│ ├── metadata.py # ExifTool & MIME mismatch detector
│ ├── strings_ioc.py # String & IOC scanner (IP, URL, Base64, shell)
│ ├── threat_intel.py # Offline/online threat intelligence
│ ├── memory_vol.py # Volatility 3 memory analysis engine
│ └── dynamic_cli.py # CLI wrappers (binwalk, tshark, objdump, gdb)
├── resources/
│ └── system_resources.py# MCP Resources
└── prompts/
└── triage_prompts.py # Structured DFIR workflowsAvailable Tools
5 toolscheck_threat_intelB
Queries threat intelligence databases (with safe offline fixture fallback) for a file hash.
Inputs: file_hash (required), case_id. Returns: result
extract_metadataB
Extracts file metadata, computes cryptographic hashes (MD5, SHA-1, SHA-256, SHA-512), and detects MIME-type masquerading.
Inputs: file_path (required), case_id. Returns: result
extract_stringsC
Extracts printable ASCII & Unicode strings from an evidence artifact.
Inputs: file_path (required), case_id, min_length, max_results, +1 more. Returns: result
scan_iocsC
Scans an evidence artifact for Indicators of Compromise: IPs, C2 URLs, email addresses, suspicious commands, and Base64 payloads.
Inputs: file_path (required), case_id. Returns: result
system_health_checkA
Inspects real-time host forensic capability readiness, storage, and chain-of-custody status.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct forensic task: system readiness, metadata extraction, string extraction, IOC scanning, and threat intel lookup. There is no functional overlap, and the descriptions clearly delineate their purposes.
All tool names follow a consistent verb_noun pattern (e.g., system_health_check, extract_metadata, scan_iocs), using snake_case throughout. The naming is predictable and aligns with forensic terminology.
Five tools is appropriate for a forensic server covering host readiness, file analysis, and threat detection. Each tool serves a necessary function without redundancy or gaps in the core workflow.
The toolset covers essential forensic steps: health check, metadata extraction, string extraction, IOC scanning, and threat intel. A minor gap is the absence of a tool for parsing specific artifact types (e.g., registry hives or logs), but the set is sufficient for basic evidence triage.
Maintenance
Related MCP Connectors
Discover, invoke, and verify ForceDream agents with cryptographic proofs. 14 local, 21 hosted tools.
34 security tools for AI agents: phishing links, exposure maps, DNS, SSL, PQC, history, pivots.
Persistent memory and knowledge management for AI agents with semantic search and 50+ tools.
Agent tools for discovery, payment safety, data extraction, and DeFi.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interface with Velociraptor for digital forensics and incident response tasks, including file/memory scans, remediation actions, and artifact collection across multiple operating systems.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables autonomous digital forensics and incident response through 21 typed forensic tools covering disk, memory, registry, network, timeline, carving, and patterns, integrated with AI-driven reasoning and self-correction.MIT
- AlicenseNot gradedqualityBmaintenanceEnables autonomous digital forensics and incident response by wrapping SIFT Workstation tools as MCP tools and orchestrating a multi-agent AI pipeline for evidence analysis and remediation planning.2MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to analyze memory dumps for forensic investigation, leveraging a fast Rust engine and full Volatility3 plugin coverage via the Model Context Protocol.1MIT