iOS Forensics MCP Server

iOS Forensics MCP Server

Model Context Protocol（MCP）を使用する、iOS ファイルシステムのフォレンジック分析サーバーです。このプロジェクトでは、Claude などの AI アシスタントが、抽出された iOS ファイルシステムにアクセスしてデジタルフォレンジック分析を行えます。

🔍 概要

iOS Forensics MCP Server は、iOS デバイスの抽出データを分析するためのツールを提供します。主な対象は次のとおりです。

• ファイルシステム分析
• WAL フォレンジックを含む SQLite データベースの解析
• Property List（plist）の解析
• iOS アーティファクトの分析（メッセージ、通話履歴、連絡先、位置情報など）
• タイムラインの生成
• フォレンジックレポートの作成

これは教育・学習用のツールとして設計されており、AI アシスタントとやり取りしながら iOS データを調査、分析できます。

🚀 機能

• ファイルシステムツール

  • メタデータ分析を伴うディレクトリの閲覧
  • ファイル形式を認識したファイル内容の表示
  • 内容およびパターンに基づくファイル検索

• SQLite 分析

  • データベースの検出とスキーマ分析
  • WAL 処理を伴う安全なクエリ実行
  • フリーリストページからの削除済みレコードの復元
  • 詳細なフォレンジック分析のためのデータベースカービング

• Plist 分析

  • バイナリおよび XML plist の解析
  • クエリパスによる値の抽出
  • タイムスタンプ分析

• iOS 専用パーサー

  • メッセージ分析（SMS／iMessage）
  • 通話履歴分析
  • 連絡先分析
  • 位置情報データ分析
  • ブラウザー履歴分析
  • 写真のジオロケーション情報の抽出
  • アプリデータ分析

• 高度な分析

  • 複数のデータソースを横断したタイムラインの生成
  • ユーザー行動分析のためのパターン認識
  • 削除済みデータの復元
  • 包括的なレポート作成

📋 要件

• Python 3.9+
• MCP 対応クライアント（Claude Desktop、Claude Code、MCP プラグインを備えた VS Code など）
• 抽出済みの iOS ファイルシステム（アクセス可能なディレクトリ）

📦 インストール

uv を使用する場合

# Install using uv
uv install ios-forensics-mcp

ソースからインストールする場合

# Clone the repository
git clone https://github.com/RLabs-Inc/ios-forensics-mcp.git
cd ios-forensics-mcp

# Install dependencies (automatically uses editable mode)
uv sync

Claude Desktop のセットアップ

MCP サーバーを Claude Desktop の設定ファイルに追加します（通常は ~/.claude/config.json、または OS に応じた同様のパスにあります）。

{
  "mcpServers": {
    "ios-forensics": {
      "command": "uv",
      "args": [
        "run",
        "ios-forensics-mcp",
        "--root-path",
        "/path/to/ios_extraction"
      ]
    }
  }
}

この設定を追加したら、Claude Desktop を再起動します。利用可能なサーバーの一覧に iOS Forensics MCP サーバーが表示されます。

Claude での使用方法

サーバーを起動し、Claude で設定したら、フォレンジックに関する質問を始めることができます。

• 「このデバイスの SMS メッセージを表示できますか？」
• 「この iPhone から位置情報を抽出して、タイムラインを作成してください」
• 「通話履歴を分析して、頻繁に連絡している電話番号を表示してください」
• 「SMS データベースから削除済みメッセージを探してください」
• 「3 月 15 日のすべてのアクティビティのレポートを作成してください」
• 「このデバイスにはどのアプリがインストールされていますか？」
• 「このデバイスの最後に確認された位置情報を表示してください」
• 「写真とそのジオロケーションデータを抽出してください」
• 「不審なアクティビティがないか、ブラウザー履歴を分析してください」
• 「電話番号が登録されている連絡先をすべて探してください」

Claude Code との連携

Claude Code で iOS Forensics MCP を使用するには、MCP サーバーとして追加する必要があります。まず、Claude Code がインストールされていることを確認してください。

# Install Claude Code if not already installed
npm install -g @anthropic-ai/claude-code

次に、iOS Forensics MCP サーバーを Claude Code に追加します。

# Add the MCP server to Claude Code
claude mcp add ios-forensics uv run ios-forensics-mcp --root-path /path/to/ios_extraction

# Or if you want to share with everyone in your project (creates .mcp.json)
claude mcp add ios-forensics -s project uv run ios-forensics-mcp --root-path /path/to/ios_extraction

# To verify the server was added
claude mcp get ios-forensics

Claude Desktop から Claude Code にこの MCP サーバーをインポートすることもできます。

# Import servers from Claude Desktop
claude mcp add-from-claude-desktop

🔧 設定

iOS フォレンジック環境をセットアップするため、設定ファイル（config.json）を作成します。

{
  "ios_filesystem": {
    "root_path": "/path/to/ios_extraction",
    "read_only": true
  },
  "server": {
    "port": 8080,
    "host": "127.0.0.1"
  }
}

🚀 使用方法

MCP サーバーの起動

# Start with default config
ios-forensics-mcp

# Start with specific config file
ios-forensics-mcp --config /path/to/config.json

# Start with specific iOS root path
ios-forensics-mcp --root-path /path/to/ios_extraction

🗂️ プロジェクト構成

ios_forensics_mcp/
├── tools/              # Tool implementations
│   ├── filesystem/     # File system tools
│   ├── sqlite/         # SQLite analysis tools
│   ├── plist/          # Property List tools
│   ├── specialized/    # iOS-specific artifact parsers
│   └── advanced/       # Advanced analysis tools
├── utils/              # Utility functions
├── models/             # Data models
└── tests/              # Test cases

📚 ドキュメント

各ツールとその機能の詳細については、ドキュメントを参照してください。

🛡️ セキュリティに関する考慮事項

このツールは実行ユーザーの権限で動作し、それに応じてファイルシステムにアクセスできます。セキュリティを確保するため、次の点に注意してください。

• 証拠を保全するため、常に読み取り専用モードで実行してください
• ディレクトリトラバーサルを防ぐため、パスを検証してください
• サーバーの実行には、専用の非特権ユーザーを使用してください
• 抽出済みの iOS ファイルシステムへのアクセスを制限してください

📝 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

🤝 貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

🙏 謝辞

• iOS のアーティファクトに関する調査とドキュメントの作成に取り組むデジタルフォレンジックコミュニティに感謝します
• このツールを実現するプロトコルを作成した MCP コミュニティに感謝します