Forensics MCP Server
自己組織化フォレンジックMCPサーバー (FastMCP / Python)
PythonとFastMCP(mcp>=2.0.0)で構築された、モジュール式のデジタルフォレンジックおよびインシデントレスポンス(DFIR)**Model Context Protocol(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と、Web 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トランスポート(Web / リモート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文字列とUnicode文字列を抽出します |
| 脅威検出 | 常に利用可能 | 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