Skip to main content
Glama
Forensics MCP Server

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


🛠️ 발견된 도구 카탈로그

도구

카테고리

동적 조건

설명

extract_metadata

메타데이터 및 파일

항상 사용 가능

해시(MD5/SHA256), EXIF 태그 계산 및 MIME 불일치 탐지

extract_strings

정적 분석

항상 사용 가능

인쇄 가능한 ASCII 및 유니코드 문자열 추출

scan_iocs

위협 탐지

항상 사용 가능

C2 URL, IP 주소, Base64 블롭, 명령 실행 스캔

check_threat_intel

위협 인텔리전스

항상 사용 가능

오프라인 서명 및 선택적 실시간 API에 대한 해시 확인

system_health_check

진단

항상 사용 가능

상태, 스토리지 확인 및 도구 준비 상태

windows_image_info

메모리 포렌식

vol 또는 Docker

Volatility 3 windows.info

windows_pslist

메모리 포렌식

vol 또는 Docker

Volatility 3 windows.pslist

windows_pstree

메모리 포렌식

vol 또는 Docker

Volatility 3 windows.pstree

windows_netscan

메모리 포렌식

vol 또는 Docker

Volatility 3 windows.netscan

windows_malfind

메모리 포렌식

vol 또는 Docker

Volatility 3 windows.malfind (주입된 코드)

binwalk_scan

파일 캐빙

binwalk 존재 시

펌웨어 서명 및 파일 시스템 캐빙

pcap_analyze

네트워크 포렌식

tshark 존재 시

PCAP 네트워크 패킷 캡처 분석

binary_disassemble

리버스 엔지니어링

objdump 존재 시

바이너리 기계 명령어 디스어셈블

gdb_inspect

디버깅

gdb 존재 시

자동화된 배치 디버깅 검사

yara_scan

서명 매칭

yara 존재 시

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 workflows

Available Tools

5 tools
check_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

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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.
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to analyze memory dumps for forensic investigation, leveraging a fast Rust engine and full Volatility3 plugin coverage via the Model Context Protocol.
      1
      MIT