Frida C2 MCP

🚀 FridaC2MCP

FridaC2MCP 是一个概念验证项目，它是一个具备可流式传输 HTTP 传输功能的 MCP 服务器，能将 Frida 强大的动态插桩能力以简单的远程服务器形式呈现。

该项目旨在直接在已 root 的 Android 设备（例如在 Termux 中）上运行，允许远程客户端通过网络分析和操作正在运行的应用程序。它就像一座桥梁，将 Frida 功能转化为可通过 HTTP 请求调用的工具，目标是实现基于代理的自动化移动安全测试。

点击查看相关内容

🚀 快速开始

此项目可直接在已 root 的 Android 设备上运行，借助网络让远程客户端对运行中的应用进行分析与操作。

✨ 主要特性

• 进程与应用管理：列出已安装的应用程序，枚举正在运行的进程，并获取前台应用程序的信息。
• 应用控制：通过应用程序的标识符或 PID 启动和终止应用程序。
• 动态插桩：通过附加到正在运行的进程来创建交互式会话。
• 远程脚本执行：在附加的会话中执行自定义的 Frida（JavaScript）脚本。脚本会使用 esbuild 进行即时打包，以确保与现代 Frida 版本兼容。这支持临时脚本和持久钩子（keep_alive=True）。

📚 详细文档

预期用例

本项目的主要目标是促进远程和自动化的移动应用程序安全测试。通过将 Frida 作为 MCP 服务器公开，渗透测试人员或自动化代理（如大语言模型）在初始设置后无需直接的 USB 连接或本地 shell 访问，即可检查和修改应用程序的行为。客户端无需安装任何 Frida 工具，因为所有工具都包含在目标设备上。

典型用例包括：

1. 远程在设备上启动目标应用程序。
2. 将 Frida 会话附加到应用程序。
3. 注入 JavaScript 钩子以绕过安全控制，例如绕过 owasp.sat.agoat 中的 root 检测检查。
4. 观察应用程序行为的变化。

架构与设计原理

系统采用客户端 - 服务器模型，有特定的设计选择以实现其独特的设备端执行环境。

• 服务器 (cli.py)：一个使用 FastMCP 和 asyncio 的 Python 脚本。它在 Android 设备本身运行，监听 HTTP 请求，并将其转换为 Frida 命令。
• 客户端：任何 HTTP 客户端都可以与服务器交互。该项目在设计时考虑了 5ire 等工具，允许生成式 AI 代理与插桩设备进行交互。
• 可流式传输的 HTTP 传输：服务器使用可流式传输的 HTTP 传输，而非简单的基于标准输入输出的传输。这是经过深思熟虑的选择，以允许进行多个并发连接，为多设备之间更复杂的代理到代理（A2A）通信场景铺平道路。
• 使用 esbuild 进行设备端脚本打包：Frida 17 及更高版本要求 JavaScript 进行压缩或打包。由于 frida-compile 难以直接在 Android 上运行，本项目使用 esbuild 作为轻量级替代方案。服务器会自动处理将 JS 代码写入临时文件、使用 esbuild 进行打包，并将结果加载到目标进程的过程。
• 手动编译的 Frida 版本：该项目目前依赖于在设备上手动编译最新的 Frida 客户端。这是由于 frida - python 库中的 C 绑定不稳定。解决方法是手动劫持与 frida - core 关联的内部工具链，并提供 Termux 原生工具。

路线图与进展

Android

• 原生工具升级：由于我有 Frida 的手动构建技术，我可以放弃 esbulid，直接在 Frida 上安装 frida - tools，这样就可以使用 frida - compile 代替 esbuild，计划发布更简洁的构建版本。这样我们就可以在设备上调用所有喜欢的 Frida 工具啦 XD

iOS

• iOS 无 root 越狱支持：我经历了一段极其痛苦的编译器地狱之旅，但我有一个（基本）可用的版本，我在运行 iOS 16.7.12 的无 root 越狱 iPhone X 上进行了测试，几乎准备好发布啦！:3
• Python3.12：这将采用自定义编译的 Python 3.12，这是一个甚至在 Procursus 仓库中都还没有的版本。它还包括一套专门为无 root 环境打补丁的自定义编译 Python 包。我认为这对于将 fastmcp 的全部功能带到 iOS 是必要的。
• 无 Node 设计：不需要 Node.js。仅支持 ObjC 进行即时编译。

致谢

本项目是 Daniel Nakov 最初的 [FridaMCP](https://github.com/dnakov/frida - mcp) 的网络版演进。虽然原始项目开创了通过标准输入输出将 Frida 用作 MCP 服务器的先河，但 FridaC2MCP 采用可流式传输的 HTTP 和现代 Frida 17 打包技术，将这一概念应用于远程多设备 C2 环境。

⚠️ 免责声明与未来计划

这是一个初步草案和概念验证。它缺乏适当的会话管理、优雅的错误处理，最重要的是，缺乏任何形式的安全措施。所有通信都是未加密和未认证的。请自行承担使用风险，并仅在安全、隔离的网络环境中使用。

未来计划包括改进会话管理、实施安全措施，并可能扩展对 iOS 的支持。