Apk Security Guard MCP Suite

🚀 APK安全防护MCP套件

本项目旨在为安卓APK安全分析与漏洞检测提供一站式自动化解决方案。通过集成JEB、JADX、APKTOOL、FlowDroid、MobSF等主流反编译、静态分析、动态分析工具，并将其统一为MCP（模型上下文协议）标准API接口，极大提升了安全分析的自动化程度与效率。适用于对APK安全有需求的安全研究人员、渗透测试人员、开发者等用户。

🚀 快速开始

环境依赖

本项目需要使用Python 3.11及以上版本，同时需要安装Node.js。

安装步骤

为避免全局环境中的依赖冲突，强烈建议使用Python虚拟环境来管理项目依赖。以下是详细的安装步骤：

1. 创建新的虚拟环境：

# 对于Windows系统
python -m venv myenv
myenv\Scripts\activate

# 对于Linux/MacOS系统
python -m venv myenv
source myenv/bin/activate

2. 确认虚拟环境已激活（命令提示符中应显示(myenv)）后，安装项目依赖：

pip install -r requirements.txt

3. 若需要使用MobSF相关API，需单独安装Node.js依赖，进入MobSF-MCP目录：

npm install -g mobsf-mcp

⚠️ 重要提示

• 建议使用Python 3.11版本。
• 每次开始新的工作会话时，记得激活虚拟环境。

插件或脚本安装建议

JEB MCP脚本

该脚本需要预先放置在JEB工具的脚本文件夹中。

1. 打开JEB，导航至文件 > 脚本 > 脚本选择器。
2. 从脚本列表中选择并运行MCP.py。
3. 若脚本成功加载并运行，你应该会在JEB输出控制台看到以下消息：

[MCP] 插件已加载
[MCP] 插件正在运行
[MCP] 服务器已在 http://localhost:16161 启动

JADX MCP插件

• 构建和运行该插件需要Java 17。
• 在JADX-MCP根目录下，运行：

./gradlew build

• 构建完成后，插件JAR文件将生成在以下路径：

plugin/build/libs/JADX-MCP-Plugin.jar

• 你也可以直接使用预构建的JAR包： 下载JADX-MCP-Plugin.jar
• 将JAR文件复制到jadx-gui安装目录的lib文件夹中：

cp plugin/build/libs/JADX-MCP-Plugin.jar <jadx-gui安装路径>/lib/

APKTool

在Windows系统上安装APKTool，你可以使用Chocolatey（一款流行的Windows包管理器）：

以管理员身份打开PowerShell。

1. 运行以下命令安装Chocolatey：

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

2. Chocolatey安装完成后，使用以下命令安装APKTool：

choco install apktool

安装完成后，你可以直接从命令行使用apktool。更多详细信息和高级用法，请参考APKTool官方文档。

MobSF MCP

首先确保已安装MobSF。

如果你希望扩展功能并添加新的API，在项目的MobSF-MCP根目录下运行以下命令：

npm run build

构建完成后，你会在build文件夹中找到生成的index.js和mobsf.js文件。

以管理员身份打开PowerShell。

• 在命令行中设置所需的环境变量：

$env:MOBSF_URL="http://localhost:8000"; 
$env:MOBSF_API_KEY="your_api_key_here"; 

• 使用以下命令启动MobSF MCP服务器：

npx mobsf-mcp

FlowDroid

要设置FlowDroid以与此套件一起使用，请按以下步骤操作：

1. 从官方发布页面下载FlowDroid的soot-infoflow-cmd-2.13.0-jar-with-dependencies.jar命令行JAR文件。
2. 在FlowDroid-MCP目录中，找到.env文件。使用文本编辑器打开它，并配置FlowDroid JAR文件的路径。例如：

FLOWDROID_WORKSPACE=../flowdroid_workspace
FLOWDROID_JAR_PATH=/home/user/tools/flowdroid/flowdroid.jar
JAVA_HOME=/usr/lib/jvm/java-11-openjdk

在flowdroid_mcp.py脚本中，FlowDroid依赖于几个关键的环境变量来运行。在运行脚本之前，请确保这些变量已正确配置。

# 第15 - 18行 
FLOWDROID_WORKSPACE = os.getenv("FLOWDROID_WORKSPACE", "flowdroid_workspace")
FLOWDROID_JAR_PATH = os.getenv("FLOWDROID_JAR_PATH", "FlowDroid.jar")
JAVA_HOME = os.getenv("JAVA_HOME")

# 第134 - 144行
command = [
    "java",
    "-jar",
    FLOWDROID_JAR_PATH,  # 确保路径正确
    "-a", apk_path,
    "-o", output_dir,
    "-p", "Android\\Sdk\\platforms",  # 必须指定平台目录
    "-s", "FlowDroid-MCP\\script\\SourcesAndSinks.txt",  # 必须指定源/汇文件
]

⚠️ 重要提示

• 请将所有路径替换为你系统的实际路径。
• 确保正确指定了Android SDK平台目录。

VSCode Cline扩展配置

要在VSCode中使用cline扩展来使用此项目，请在你的cline配置文件中添加以下配置：

{
    "mcpServers": {
        "Jadx MCP Server": {
            "disabled": false,
            "timeout": 60,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "JADX-MCP\\fastmcp_adapter.py"
            ],
            "transportType": "stdio"
        },
        "JEB MCP Server": {
            "disabled": false,
            "timeout": 1800,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "JEB-MCP\\server.py"
            ],
            "transportType": "stdio"
        },
        "FlowDroid MCP Server": {
            "disabled": false,
            "timeout": 60,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "FlowDroid-MCP\\script\\flowdroid_mcp.py"
            ],
            "transportType": "stdio"
        },
        "MobSF MCP Server": {
            "disabled": false,
            "timeout": 60,
            "command": "Nodejs\\node.exe",
            "args": [
                "MobSF-MCP\\build\\index.js"
            ],
            "env": {
                "MOBSF_URL": "http://localhost:8000",
                "MOBSF_API_KEY": "your_api_key_here"
            },
            "transportType": "stdio"
        },
        "APKTOOL MCP Server": {
            "disabled": false,
            "timeout": 60,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "APKTOOL-MCP\\apktool_mcp_server.py"
            ],
            "transportType": "stdio"
        }
    }
}

⚠️ 重要提示

请根据你的实际文件路径和配置（根据你的系统进行调整）进行调整。 请确保在配置中填写你实际的MOBSF_API_KEY。

✨ 主要特性

• 集成主流反编译、静态分析、动态分析工具，提供一站式自动化解决方案。
• 统一为MCP标准API接口，提升安全分析的自动化程度与效率。
• 采用“多专家决策”模型，提高漏洞发现的全面性和结果的可信度。

📦 安装指南

依赖安装

为避免全局环境中的依赖冲突，强烈建议使用Python虚拟环境来管理项目依赖。以下是详细的安装步骤：

1. 创建新的虚拟环境：

# 对于Windows系统
python -m venv myenv
myenv\Scripts\activate

# 对于Linux/MacOS系统
python -m venv myenv
source myenv/bin/activate

2. 确认虚拟环境已激活（命令提示符中应显示(myenv)）后，安装项目依赖：

pip install -r requirements.txt

3. 若需要使用MobSF相关API，需单独安装Node.js依赖，进入MobSF-MCP目录：

npm install -g mobsf-mcp

插件或脚本安装

JEB MCP脚本

该脚本需要预先放置在JEB工具的脚本文件夹中。

1. 打开JEB，导航至文件 > 脚本 > 脚本选择器。
2. 从脚本列表中选择并运行MCP.py。
3. 若脚本成功加载并运行，你应该会在JEB输出控制台看到以下消息：

[MCP] 插件已加载
[MCP] 插件正在运行
[MCP] 服务器已在 http://localhost:16161 启动

JADX MCP插件

• 构建和运行该插件需要Java 17。
• 在JADX-MCP根目录下，运行：

./gradlew build

• 构建完成后，插件JAR文件将生成在以下路径：

plugin/build/libs/JADX-MCP-Plugin.jar

• 你也可以直接使用预构建的JAR包： 下载JADX-MCP-Plugin.jar
• 将JAR文件复制到jadx-gui安装目录的lib文件夹中：

cp plugin/build/libs/JADX-MCP-Plugin.jar <jadx-gui安装路径>/lib/

APKTool

在Windows系统上安装APKTool，你可以使用Chocolatey（一款流行的Windows包管理器）：

以管理员身份打开PowerShell。

1. 运行以下命令安装Chocolatey：

Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

2. Chocolatey安装完成后，使用以下命令安装APKTool：

choco install apktool

安装完成后，你可以直接从命令行使用apktool。更多详细信息和高级用法，请参考APKTool官方文档。

MobSF MCP

首先确保已安装MobSF。

如果你希望扩展功能并添加新的API，在项目的MobSF-MCP根目录下运行以下命令：

npm run build

构建完成后，你会在build文件夹中找到生成的index.js和mobsf.js文件。

以管理员身份打开PowerShell。

• 在命令行中设置所需的环境变量：

$env:MOBSF_URL="http://localhost:8000"; 
$env:MOBSF_API_KEY="your_api_key_here"; 

• 使用以下命令启动MobSF MCP服务器：

npx mobsf-mcp

FlowDroid

要设置FlowDroid以与此套件一起使用，请按以下步骤操作：

1. 从官方发布页面下载FlowDroid的soot-infoflow-cmd-2.13.0-jar-with-dependencies.jar命令行JAR文件。
2. 在FlowDroid-MCP目录中，找到.env文件。使用文本编辑器打开它，并配置FlowDroid JAR文件的路径。例如：

FLOWDROID_WORKSPACE=../flowdroid_workspace
FLOWDROID_JAR_PATH=/home/user/tools/flowdroid/flowdroid.jar
JAVA_HOME=/usr/lib/jvm/java-11-openjdk

在flowdroid_mcp.py脚本中，FlowDroid依赖于几个关键的环境变量来运行。在运行脚本之前，请确保这些变量已正确配置。

# 第15 - 18行 
FLOWDROID_WORKSPACE = os.getenv("FLOWDROID_WORKSPACE", "flowdroid_workspace")
FLOWDROID_JAR_PATH = os.getenv("FLOWDROID_JAR_PATH", "FlowDroid.jar")
JAVA_HOME = os.getenv("JAVA_HOME")

# 第134 - 144行
command = [
    "java",
    "-jar",
    FLOWDROID_JAR_PATH,  # 确保路径正确
    "-a", apk_path,
    "-o", output_dir,
    "-p", "Android\\Sdk\\platforms",  # 必须指定平台目录
    "-s", "FlowDroid-MCP\\script\\SourcesAndSinks.txt",  # 必须指定源/汇文件
]

⚠️ 重要提示

• 请将所有路径替换为你系统的实际路径。
• 确保正确指定了Android SDK平台目录。

VSCode Cline扩展配置

要在VSCode中使用cline扩展来使用此项目，请在你的cline配置文件中添加以下配置：

{
    "mcpServers": {
        "Jadx MCP Server": {
            "disabled": false,
            "timeout": 60,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "JADX-MCP\\fastmcp_adapter.py"
            ],
            "transportType": "stdio"
        },
        "JEB MCP Server": {
            "disabled": false,
            "timeout": 1800,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "JEB-MCP\\server.py"
            ],
            "transportType": "stdio"
        },
        "FlowDroid MCP Server": {
            "disabled": false,
            "timeout": 60,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "FlowDroid-MCP\\script\\flowdroid_mcp.py"
            ],
            "transportType": "stdio"
        },
        "MobSF MCP Server": {
            "disabled": false,
            "timeout": 60,
            "command": "Nodejs\\node.exe",
            "args": [
                "MobSF-MCP\\build\\index.js"
            ],
            "env": {
                "MOBSF_URL": "http://localhost:8000",
                "MOBSF_API_KEY": "your_api_key_here"
            },
            "transportType": "stdio"
        },
        "APKTOOL MCP Server": {
            "disabled": false,
            "timeout": 60,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "APKTOOL-MCP\\apktool_mcp_server.py"
            ],
            "transportType": "stdio"
        }
    }
}

⚠️ 重要提示

请根据你的实际文件路径和配置（根据你的系统进行调整）进行调整。 请确保在配置中填写你实际的MOBSF_API_KEY。

📚 详细文档

API文档

JEB MCP

架构基于https://github.com/flankerhqd/jebmcp

✨ 主要API功能：

参数说明：

• filepath应为APK文件的绝对路径。
• method_signature和class_signature使用Java风格的内部地址，例如方法为Lcom/abc/Foo;->bar(I[JLjava/Lang/String;)V，类为Lcom/abc/Foo;。

JADX MCP

架构基于https://github.com/mobilehackinglab/jadx-mcp-plugin

✨ 主要API功能：

参数说明：

• class_name应为完全限定类名，例如com.example.MyClass。
• method_name是反编译代码中显示的方法名。
• limit和offset用于列出类时的分页。
• query：搜索关键字，用于搜索包含该关键字的类名或方法名。
• return_type：方法的返回类型，用于按返回类型搜索方法。
• field_name：字段的名称，用于获取字段的详细信息。

APKTool MCP

架构基于https://github.com/zinja-coder/apktool-mcp-server（Apache 2.0许可证）

✨ 主要API功能：

参数说明：

• project_dir：APKTool项目目录的路径。
• apk_path：APK文件的路径。
• class_name：完全限定类名（例如"com.example.MyClass"）。
• resource_type：资源目录名称（例如"layout"，"drawable"，"values"）。
• create_backup：修改前是否创建备份（默认：True）。
• file_extensions：要搜索的文件扩展名列表（默认：[".smali", ".xml"]）。

MobSF MCP

✨ 主要API功能：

📊 报告部分API： MobSF提供了详细的特定部分API，用于访问分析报告的不同部分。每个部分可以使用getJsonSection_{section}(hash)进行访问：

参数说明：

• file：移动应用程序文件（APK、IPA或APPX）的路径。
• hash：分析应用程序的MD5哈希值。
• section：要检索的报告部分的名称。
• page：分页结果的页码。
• pageSize：每页的项目数。
• type：文件类型（apk/ipa/studio/eclipse/ios）。
• rule：抑制管理的规则ID。
• kind：抑制类型（规则/文件）。

FlowDroid MCP

✨ 主要API功能：

参数说明：

• apk_path：要分析的APK文件的路径。
• output_dir：可选输出目录（默认为workspace/apk_name）。
• analysis_dir：FlowDroid分析输出目录的路径。

多专家决策模型

本项目采用“多专家决策”模型对APK安全进行全面分析。该模型借鉴了多位专家独立判断和集体决策的思想，结合了5种主流逆向分析工具（JEB、JADX、APKTool、FlowDroid、MobSF）的MCP接口，大大提高了漏洞发现的全面性和结果的可信度。

分析过程概述

1. 多位专家独立作答

   • 5种逆向分析工具（MCP）对同一个APK独立进行静态分析，并自动生成各自的漏洞报告。
   • 每个工具作为一个“专家”，从不同的视角和技术细节独立发现潜在的安全问题。

2. 大模型频率统计与排序

   • 使用大模型对所有工具输出的漏洞进行合并、去重和内容分析，统计每个漏洞在5个工具报告中的出现频率，并记录其来源。
   • 按出现频率对所有漏洞进行排序。出现频率越高，可信度越高。

3. 本地优先筛选与分流

   • 自动保留前60%的高频漏洞（即在5个工具中出现频率较高、可信度较高的漏洞）在本地。
   • 将后40%的漏洞分为两类：
     • 无MobSF来源：即仅由其他逆向工具发现的漏洞，全部保留。
     • 有MobSF来源：即仅出现在MobSF报告中的低频漏洞，交给大模型进一步评估其危险性，仅保留高风险漏洞。

4. 最终综合整合 将第三步中本地保留的所有高优先级漏洞、独特漏洞以及大模型评估为高风险的MobSF漏洞进行整合，生成最终的综合漏洞分析报告。

CrossValidation_APKAnalysis MCP

✨ 主要API功能：

参数说明：

• apk_path：要分析的APK文件的绝对路径。
• report_paths：每个工具的标准化报告文件路径列表。
• combined_report_path：合并后的初步综合报告的路径。
• mobsf_low_priority_path：仅来自MobSF的低优先级漏洞的路径。
• high_priority_path，unique_low_priority_path，high_risk_mobsf_path：不同优先级漏洞报告的路径。

VSCode Cline扩展配置

要在VSCode中使用cline扩展来使用此项目，请在你的cline配置文件中添加以下配置：

{
    "mcpServers": {
        "apk_analysis": {
            "disabled": false,
            "timeout": 60,
            "command": "myenv\\Scripts\\python.exe",
            "args": [
                "CrossValidation_APKAnalysis.py"
            ],
            "transportType": "stdio"
        }
    }
}

通过以上过程，项目实现了多工具、多视角的漏洞发现和自动化决策，大大提高了分析结果的全面性、准确性和实用价值。

🔧 技术细节

本项目使用“多专家决策”模型，结合5种主流逆向分析工具（JEB、JADX、APKTool、FlowDroid、MobSF）的MCP接口，对APK安全进行全面分析。具体技术细节如下：

1. 多位专家独立作答：5种逆向分析工具（MCP）对同一个APK独立进行静态分析，并自动生成各自的漏洞报告。每个工具作为一个“专家”，从不同的视角和技术细节独立发现潜在的安全问题。
2. 大模型频率统计与排序：使用大模型对所有工具输出的漏洞进行合并、去重和内容分析，统计每个漏洞在5个工具报告中的出现频率，并记录其来源。按出现频率对所有漏洞进行排序，出现频率越高，可信度越高。
3. 本地优先筛选与分流：自动保留前60%的高频漏洞在本地，将后40%的漏洞分为两类：无MobSF来源的漏洞全部保留，有MobSF来源的漏洞交给大模型进一步评估其危险性，仅保留高风险漏洞。
4. 最终综合整合：将本地保留的所有高优先级漏洞、独特漏洞以及大模型评估为高风险的MobSF漏洞进行整合，生成最终的综合漏洞分析报告。

📄 许可证

本项目采用Apache License 2.0许可协议 - 详情请参阅LICENSE文件。

🙏 致谢

本项目基于并集成了多个优秀的开源工具和项目。

特别感谢：

• 所有集成工具的开发者和维护者
• 开源社区的持续贡献
• 所有帮助改进本项目的贡献者

⚠️ 免责声明和法律声明

本工具套件仅设计用于安全研究人员、渗透测试人员和开发者进行合法的安全测试和分析。用户必须：

1. 仅分析自己拥有或获得明确测试许可的应用程序。
2. 遵守所有适用的法律法规。
3. 尊重知识产权和服务条款。
4. 负责任且合乎道德地使用这些工具。

用户必须确保其使用本工具符合：

• 本地和国际法律
• 软件许可协议
• 被分析应用程序的服务条款
• 数据保护和隐私法规

🤝 贡献

我们热烈欢迎社区的贡献！无论你是修复漏洞、改进文档、添加新功能还是提出改进建议，我们都非常感谢你的帮助。

• 🐛 报告漏洞和问题
• 💡 提出新功能或改进建议
• 📝 改进文档
• 🔍 审查代码和拉取请求
• 💻 提交拉取请求

我们致力于共同使这个项目变得更好。你的贡献将使这个工具对整个安全研究社区更加强大和有用。