Ios Forensics MCP

🚀 iOS 法医 MCP 服务器

这是一个用于分析 iOS 文件系统的法医分析服务器，借助模型上下文协议（MCP），能让像 Claude 这样的 AI 助手访问并分析提取的 iOS 文件系统，助力数字取证工作。

🚀 快速开始

iOS 法医 MCP 服务器提供了分析 iOS 设备提取文件的工具，可进行文件系统分析、SQLite 数据库解析、属性列表（plist）解析等操作。此项目设计为教育/学习工具，允许用户与 AI 助手交互以探索和分析 iOS 数据。

安装说明

1. 从源代码安装 克隆仓库并运行安装脚本：

git clone https://github.com/rlabs-inc/ios-forensics-mcp.git
cd ios-forensics-mcp
./install.sh

2. 依赖管理 使用 requirements.txt 管理 Python 依赖项。
3. 配置文件 创建并编辑 config.json 文件以设置分析参数。

配置示例

{
  "tools": {
    "sqlite": {
      "enabled": true,
      "database_path": "/path/to/databases"
    },
    "plist": {
      "enabled": true,
      "plist_path": "/path/to/plists"
    }
  },
  "logging": {
    "level": "INFO",
    "output_file": "analysis.log"
  }
}

启动 MCP 服务器

# 使用默认配置启动
ios-forensics-mcp

# 指定配置文件启动
ios-forensics-mcp --config /path/to/config.json

# 指定 iOS 根目录路径
ios-forensics-mcp --root-path /path/to/ios_extraction

✨ 主要特性

• 文件系统工具
  • 可进行目录导航及元数据解析。
  • 支持文件内容查看及类型识别。
  • 能基于内容和模式匹配进行文件搜索。
• SQLite 分析
  • 可发现数据库并解析其架构。
  • 能安全执行查询（包括 WAL 处理）。
  • 可恢复自由列表页中的已删除记录。
  • 支持数据库切割以实现深度法证分析。
• plist 分析
  • 能解析二进制和 XML plist。
  • 可提取值并转换为结构化数据。
  • 能识别与重建已删除项目。
• 特殊功能
  • 可解析信息日志。
  • 能收集应用日志。
  • 可分析系统缓存。

📦 安装指南

安装要求

• 操作系统：Linux、macOS 或 Windows（通过 WSL 支持）
• Python 版本：3.8 或更高版本
• 权限：仅读模式运行以保护证据完整性

安装步骤

1. 从源代码安装 克隆仓库并运行安装脚本：

git clone https://github.com/rlabs-inc/ios-forensics-mcp.git
cd ios-forensics-mcp
./install.sh

2. 依赖管理 使用 requirements.txt 管理 Python 依赖项。
3. 配置文件 创建并编辑 config.json 文件以设置分析参数。

💻 使用示例

基础用法

# 使用默认配置启动
ios-forensics-mcp

高级用法

# 指定配置文件启动
ios-forensics-mcp --config /path/to/config.json

# 指定 iOS 根目录路径
ios-forensics-mcp --root-path /path/to/ios_extraction

📚 详细文档

关于每个工具及其功能的详细文档，请参阅文档。

🔧 技术细节

项目结构

ios_forensics_mcp/
├── tools/              # 工具实现
│   ├── filesystem/     # 文件系统工具
│   ├── sqlite/         # SQLite 分析工具
│   ├── plist/          # Property List 工具
│   └── specialized/    # iOS 特定日志解析器
└── utils/              # 公共功能函数

🛡️ 安全注意事项

⚠️ 重要提示

此工具以执行用户的权限运行，并相应地访问文件系统。安全建议如下：

• 总是以只读模式运行以保护证据。
• 验证路径以防止目录遍历攻击。
• 使用无特权的专用用户来运行服务器。
• 限制对提取的 iOS 文件系统的访问。

📄 许可证

该项目在 MIT 许可证下发行。详细信息请参阅 LICENSE 文件。

🤝 贡献

欢迎贡献！请随意提交 Pull Request。

🙏 致谢

• 感谢数字取证社区对 iOS 遗留的研究和文档。
• 感谢 MCP 社区创建使得此工具成为可能的协议。