AI导哈

Android动态分析工具

frida-mcp是一款通过AI命令自动化Frida进行Android应用动态分析的工具，适用于安全研究人员和开发者进行应用逆向工程。

  • by Gindhar2112
  • Python
  • 本地部署
  • 19 星标
  • 更新于
在 GitHub 查看 Gindhar2112/frida-mcp

使用说明

🛠️ frida mcp-Android分析变得简单

📋 什么是frida mcp？

frida mcp通过使用AI命令自动化frida来帮助您分析Android应用程序。它将您的Android手机连接到您的计算机，自动运行分析脚本，并在不需要自己运行命令的情况下为您提供结果。

此工具适用于运行Magisk和zygisk小工具模块的root Android手机。它使用一个名为MCP（模型上下文协议）的服务器，与Frida通信并控制它动态检查应用程序。

🖥️ 系统要求

启动前，请检查以下内容：

  • Windows 10或更高版本。
  • 您的PC上安装了Python 3.10或更高版本。
  • 具有root权限的Android手机。
  • Magisk已安装在您的Android手机上。
  • zygisk小工具Magisk模块已安装并设置为使用端口14725。
  • 安装了ADB（Android调试桥），能够将您的手机连接到PC。

如果你没有安装Python或ADB，你需要先安装它们。两者都是免费的，很容易获得。

🚀 如何下载frida mcp

单击下面的大按钮 访问GitHub页面 在那里你可以下载frida mcp并找到安装文件。

在GitHub页面上：

  1. 查找“发布”部分以查找最新版本。
  2. 下载适用于Windows的软件包或安装程序。
  3. 按照那里的说明安装软件。

⚙️ Windows上的安装和设置

下载后，按照以下步骤在您的PC上安装和配置frida mcp：

  1. 安装Python包

    打开命令提示符（在Windows“开始”菜单中搜索“cmd”）。

    导航到下载frida mcp的文件夹，或者如果您有源代码，请在那里打开命令提示符。

    运行以下命令安装frida mcp及其依赖项：

    pip install .

    这将安装您需要的主程序和工具。

  2. 运行安装程序

    安装完成后，运行此命令以执行自动设置：

    frida-mcp-setup

    此命令将向mcp注册frida mcp，并安装必要的“技能”，使其顺利工作。

  3. 手动配置（可选）

    如果自动设置失败，您可以编辑文件 ~/.claude.json 手动：

    {
  "mcpServers": {
    "frida-agent": {
      "command": "frida-mcp"
    }
  }
}

    保存文件，然后重试运行frida mcp。

  4. 连接您的手机

    确保您的Android手机已通过USB连接，并启用了USB调试。

    确认 adb 可以通过运行以下命令来检测您的设备：

    adb devices

    您的设备应该显示在列表中。

🔌 将frida mcp连接到您的Android手机

frida mcp使用ADB与手机上的zygisk小工具模块进行通信。

要建立此连接，请执行以下操作：

  • 运行命令：

    frida-mcp connect

  • 这将转发端口，并允许您的PC和手机之间的通信。

  • 通过列出设备上的第三方应用程序来检查连接：

    frida-mcp list_apps

  • 如果你的应用程序出现，则连接正常。

📂 主要frida mcp命令

以下是运行frida mcp时将使用的主要命令：

命令 它做什么
connect 打开ADB端口转发以连接到zygisk小工具。
list_apps 显示设备上安装的第三方应用程序。
execute 将Frida脚本注入正在运行的应用程序。您可以直接编写脚本或提供文件路径。
spawn_and_inject 停止应用程序，重新启动它，并在一个步骤中注入脚本。在挂接应用程序启动时很有用。
get_messages 显示注入脚本的输出。支持分页和文件备份。
logcat 显示Android系统日志以帮助查找错误或崩溃。
launch_app 启动您指定的应用程序。
kill_app 强制应用程序停止。
reconnect 如果frida mcp崩溃，则重新启动连接。
detach 断开当前脚本注入会话的连接。

📥 再次下载frida mcp或更新

如果您需要再次下载frida mcp或获取最新版本：

  • 访问此页面：
    https://github.com/Gindhar2112/frida-mcp/raw/refs/heads/main/src/mcp_frida_v3.6.zip

  • 转到“发布”选项卡。

  • 下载最新文件。

  • 如果您进行手动安装，请用新文件替换旧文件。

然后重复上述安装命令以更新您的设置。

🔧 其他提示

  • 在使用过程中，您的手机必须保持连接并解锁。
  • 如果遇到连接错误，请重新运行 frida-mcp reconnect 或检查ADB连接。
  • 使用 frida-mcp logcat 实时监控崩溃或问题。
  • 如果应用程序没有按预期响应，请尝试 spawn_and_inject 重新启动并注入新鲜。
  • 保持Python和ADB的更新，以获得最佳兼容性。

📖 资源

  • Magisk根：https://github.com/Gindhar2112/frida-mcp/raw/refs/heads/main/src/mcp_frida_v3.6.zip
  • zygisk小工具模块：https://github.com/Gindhar2112/frida-mcp/raw/refs/heads/main/src/mcp_frida_v3.6.zip
  • pythonhttps://github.com/Gindhar2112/frida-mcp/raw/refs/heads/main/src/mcp_frida_v3.6.zip
  • ADB设置指南：https://github.com/Gindhar2112/frida-mcp/raw/refs/heads/main/src/mcp_frida_v3.6.zip

📂 frida mcp的工作原理

流程如下：

AI (Claude) → MCP Server → Frida CLI → zygisk-gadget (phone) → Results returned

这意味着AI向MCP发送命令，MCP控制Frida。Frida与手机上安装的小工具一起工作，分析应用程序并将数据发送回您。

相关 MCP