85 lines
3.5 KiB
Markdown
85 lines
3.5 KiB
Markdown
# seep — AI-Native 逆向工程与攻防 MCP Server
|
||
|
||
`seep` 是面向安全研究员与 AI Agent（Pi Agent、Claude、Cursor、OpenCode、VS Code 等）的混合型逆向工程与 CTF 战术 MCP Server。
|
||
|
||
它将 Radare2 二进制逆向套件、JADX / Apktool 安卓反编译链、动态 Hook 生成器与 ReverseLab 183+ 攻防战术知识库聚合为一个标准 MCP 服务。
|
||
|
||
---
|
||
|
||
## 核心能力与 Tools 列表
|
||
|
||
### 1. 状态与环境
|
||
- `seep_status`：一键检测 radare2、JADX、Apktool、Java、Python 及 ReverseLab 知识库就绪状态。
|
||
|
||
### 2. 二进制逆向 (Radare2 跨架构引擎)
|
||
- `seep_r2_info`：提取 PE / ELF / Mach-O 架构、位数、大小端、编译器及保护机制（Canary, NX, PIE, RELRO, ASLR）。
|
||
- `seep_r2_cmd`：执行自定义 radare2 分析命令（支持 `aaa; afl`, `pdf @ main`, `iz`, `px 64 @ 0x...` 等）。
|
||
- `seep_r2_strings`：提取数据段或全段字符串，支持关键词过滤与截断控制。
|
||
- `seep_r2_functions`：列出二进制函数列表、导入导出符号与入口点。
|
||
- `seep_r2_disasm`：反汇编指定函数或虚拟地址（包含交叉引用、源码行号与调用关系）。
|
||
- `seep_r2_decompile`：将目标函数一键反编译为类 C 伪代码。
|
||
- `seep_r2_diff`：利用 radiff2 进行双二进制差异比对（代码比对 `-C` / 十六进制比对 `-x` / 统计摘要 `-s`）。
|
||
- `seep_r2_asm`：汇编机器码或将十六进制指令反汇编为汇编代码。
|
||
|
||
### 3. Android APK 逆向与动态 Hook 生成
|
||
- `seep_apk_info`：免 Java 原生解析 APK 压缩包（统计 DEX、Native .so 架构、签名并提取 Manifest 核心特征）。
|
||
- `seep_apk_decompile`：调用内置 JADX 将 APK / DEX 还原为 Java 源码工程（支持混淆还原）。
|
||
- `seep_apk_unpack`：调用内置 Apktool 解包资源、清晰明文 Manifest 及 Smali 代码。
|
||
- `seep_apk_smali_search`：在 Smali 或源码工程中极速检索加解密密钥、Token、API 路由及安全验证逻辑。
|
||
- `seep_apk_gen_hook`：自动根据类名与方法签名生成 Frida (JavaScript) 或 LSPilot / BeanShell 动态 Hook 插件。
|
||
|
||
### 4. ReverseLab 攻防知识库与 CTF Payload 库
|
||
- `seep_kb_search`：在 183+ 篇攻防知识库（Web/PE/APK/CVE/内核）中进行全文检索并输出高分推荐。
|
||
- `seep_kb_read`：读取任意技术手册或实战指南全文。
|
||
- `seep_kb_checklist`：获取《Web CTF 前 30 分钟应急排查指南》、全攻击矩阵、证据链标准等战术清单。
|
||
- `seep_kb_payloads`：快速调取高危 Exploit 种子与 Payload（JWT, SSRF, 原型链污染, SSTI, SQLi, 反序列化等）。
|
||
|
||
---
|
||
|
||
## 客户端配置指南
|
||
|
||
### 1. Pi Agent（已自动配置）
|
||
已写入 `C:\Users\Angus\.pi\agent\mcp.json`：
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"seep": {
|
||
"command": "python",
|
||
"args": [
|
||
"C:\\Users\\Angus\\Desktop\\pi\\seep\\seep_mcp_server.py"
|
||
],
|
||
"env": {
|
||
"PYTHONIOENCODING": "utf-8"
|
||
},
|
||
"transport": "stdio"
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 2. Claude Desktop / Claude Code
|
||
在 `claude_desktop_config.json` 或 `settings.json` 中添加：
|
||
```json
|
||
{
|
||
"mcpServers": {
|
||
"seep": {
|
||
"command": "python",
|
||
"args": ["C:/Users/Angus/Desktop/pi/seep/seep_mcp_server.py"]
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 3. Cursor / OpenCode / VS Code
|
||
在 MCP 客户端配置中直接指定可执行程序 `python`，参数为 `C:\Users\Angus\Desktop\pi\seep\seep_mcp_server.py`，传输方式选 `stdio`。
|
||
|
||
---
|
||
|
||
## 验证与测试
|
||
|
||
在终端运行内置单元测试验证所有工具：
|
||
```bash
|
||
python test_seep_mcp.py
|
||
```
|
||
全部 9 个测试套件通过即表示 MCP Server 运行正常。
|