# SO Analyzer MCP

Native库（SO文件）分析工具，支持Flutter应用抓包。**免费开源的IDA Pro替代品！**

## 🎯 特色功能

- ✅ **反编译** - 支持radare2/Ghidra/轻量级模式
- ✅ **函数识别** - 识别所有函数（包括未导出）
- ✅ **调用图分析** - 生成DOT格式可视化
- ✅ **控制流图** - 基本块分析
- ✅ **Flutter SSL绕过** - 一键完成
- ✅ **字符串加密检测** - 熵值分析+XOR检测

## 📊 工具总览 (30个)

### SO基础分析 (8个)

| 工具 | 说明 |
|------|------|
| `so_check_env` | 检查分析环境 |
| `so_list_libs` | 列出APK中的所有SO库 |
| `so_extract` | 从APK提取SO文件 |
| `so_info` | 获取SO基本信息 |
| `so_exports` | 获取导出函数列表 |
| `so_imports` | 获取导入函数列表 |
| `so_strings` | 提取字符串 |
| `so_search_symbol` | 搜索符号 |

### Flutter专用 (6个)

| 工具 | 说明 |
|------|------|
| `flutter_detect` | 检测是否是Flutter应用 |
| `flutter_get_version` | 获取Flutter版本 |
| `flutter_find_ssl` | 查找SSL验证函数 |
| `flutter_ssl_offset_v2` | ⭐智能定位SSL函数 |
| `flutter_patch_ssl` | Patch SSL验证（绕过证书） |
| `flutter_patch_apk` | **一键patch Flutter APK** |

### 二进制修改 (5个)

| 工具 | 说明 |
|------|------|
| `so_patch_bytes` | 修改指定偏移的字节 |
| `so_search_bytes` | 搜索字节模式 |
| `so_replace_bytes` | 查找并替换字节 |
| `so_disassemble` | 反汇编代码 |
| `so_get_function_bytes` | 获取函数字节码 |

### 交叉引用分析 (4个)

| 工具 | 说明 |
|------|------|
| `so_xref_string` | ⭐查找字符串交叉引用 |
| `so_find_function` | 根据地址查找函数 |
| `so_analyze_function` | 分析函数特征 |
| `so_get_sections` | 获取代码段信息 |

### ⭐ 高级分析 (9个) - NEW!

| 工具 | 说明 |
|------|------|
| `so_list_all_functions` | 识别所有函数（包括未导出） |
| `so_callgraph` | 生成调用关系图 + DOT图 |
| `so_get_cfg` | 生成控制流图 + DOT图 |
| `so_analyze_function_advanced` | 全面函数分析 |
| `so_decompile` | ⭐反编译生成伪代码 |
| `so_detect_encryption` | 字符串加密检测 |
| `so_trace_register` | 数据流/寄存器追踪 |
| `so_check_radare2` | 检查radare2环境 |
| `so_check_ghidra` | 检查Ghidra环境 |

## 安装

```bash
cd so-analyzer-mcp
pip install -r requirements.txt
```

## MCP配置

```json
{
  "mcpServers": {
    "so-analyzer": {
      "command": "python",
      "args": ["K:/path/to/so-analyzer-mcp/run_server.py"]
    }
  }
}
```

## 使用示例

```python
# 1. 列出SO库
so_list_libs(apk_path="app.apk")

# 2. 检测Flutter
flutter_detect(apk_path="app.apk")

# 3. 提取SO文件
so_extract(apk_path="app.apk", lib_name="libflutter.so", arch="arm64-v8a")

# 4. 搜索SSL相关函数
so_search_symbol(so_path="libflutter.so", pattern="ssl")

# 5. 提取字符串
so_strings(so_path="libflutter.so", search="certificate")
```

## 项目结构

```
so-analyzer-mcp/
├── so_analyzer/
│   ├── __init__.py
│   ├── config.py           # 配置
│   ├── server.py           # MCP服务器 (30个工具)
│   ├── so_utils.py         # SO基础分析
│   ├── flutter_utils.py    # Flutter专用工具
│   ├── flutter_utils_v2.py # Flutter SSL智能定位
│   ├── patch_utils.py      # 二进制修改
│   ├── xref_utils.py       # 交叉引用分析
│   ├── advanced_utils.py   # 高级分析 (NEW!)
│   └── decompile_utils.py  # 反编译工具 (NEW!)
├── radare2/               # radare2 (可选)
├── run_server.py          # 启动脚本
├── requirements.txt
└── README.md
```

## 依赖

**必需**:
- **mcp** - MCP协议库
- **lief** - 二进制文件解析库
- **capstone** - 反汇编引擎

**可选**:
- **radare2** - 反编译 (推荐，~50MB)
- **Ghidra** - 高质量反编译 (~400MB)

## 已完成功能 ✅

- [x] Flutter SSL Patch (一键绕过)
- [x] SO文件修改
- [x] 反编译 (radare2/Ghidra/简单模式)
- [x] 函数识别 (包括未导出)
- [x] 调用图分析
- [x] 控制流图
- [x] 字符串加密检测
- [x] 数据流分析

## 与 IDA Pro MCP 对比

| 功能 | IDA Pro MCP | SO Analyzer MCP |
|------|-------------|-----------------|
| 反编译 | ✅ Hex-Rays | ✅ radare2 |
| 函数识别 | ✅ | ✅ |
| 调用图 | ✅ | ✅ |
| 控制流图 | ✅ | ✅ |
| Flutter SSL | ❌ | ✅ 一键完成 |
| APK操作 | ❌ | ✅ |
| 价格 | $1000+ | **免费** |