JinDaGe - apk-security-guard-mcp-suite MCP Details

article

README

🚀 APK安全防护MCP套件

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

🚀 快速开始

环境依赖

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

安装步骤

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

创建新的虚拟环境：

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

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

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

pip install -r requirements.txt

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

npm install -g mobsf-mcp

⚠️ 重要提示

建议使用Python 3.11版本。

每次开始新的工作会话时，记得激活虚拟环境。

插件或脚本安装建议

JEB MCP脚本

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

打开JEB，导航至文件 > 脚本 > 脚本选择器。
从脚本列表中选择并运行MCP.py。
若脚本成功加载并运行，你应该会在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。

运行以下命令安装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'))

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以与此套件一起使用，请按以下步骤操作：

从官方发布页面下载FlowDroid的soot-infoflow-cmd-2.13.0-jar-with-dependencies.jar命令行JAR文件。
在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虚拟环境来管理项目依赖。以下是详细的安装步骤：

创建新的虚拟环境：

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

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

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

pip install -r requirements.txt

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

npm install -g mobsf-mcp

插件或脚本安装

JEB MCP脚本

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

打开JEB，导航至文件 > 脚本 > 脚本选择器。
从脚本列表中选择并运行MCP.py。
若脚本成功加载并运行，你应该会在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。

运行以下命令安装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'))

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以与此套件一起使用，请按以下步骤操作：

从官方发布页面下载FlowDroid的soot-infoflow-cmd-2.13.0-jar-with-dependencies.jar命令行JAR文件。
在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功能： | API | 描述 | |-----|-------------| | ping() | 检查JEB MCP服务器是否存活。 | | get_manifest(filepath) | 从APK中获取AndroidManifest.xml内容。 | | get_apk_permissions(filepath) | 提取APK的AndroidManifest.xml中声明的所有权限。 | | get_apk_components(filepath) | 从清单中提取所有四个主要的安卓组件（活动、服务、接收器、提供者）及其属性。 | | get_method_decompiled_code(filepath, method_signature) | 通过其完全限定签名获取特定方法的反编译代码。 | | get_class_decompiled_code(filepath, class_signature) | 通过其完全限定签名获取特定类的反编译代码。 | | get_method_callers(filepath, method_signature) | 列出给定方法的所有调用者。 | | get_method_overrides(filepath, method_signature) | 列出给定方法的所有重写方法。 | | get_apk_info(filepath) | 获取APK的基本信息，如包名、版本和主活动。 | | get_intent_filters(filepath) | 提取活动、服务和接收器的所有意图过滤器（动作、类别、数据）。 | | get_exported_components(filepath) | 列出所有导出的组件（显式或隐式）及其属性。 | | list_broadcast_receivers(filepath) | 列出所有广播接收器及其意图过滤器。 |

参数说明：

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功能： | API | 描述 | |-----|-------------| | list_all_classes(limit, offset) | 返回APK中所有类名的分页列表。参数：limit（最大结果数，默认250），offset（起始索引，默认0）。 | | search_class_by_name(query) | 搜索包含给定关键字的类名（不区分大小写）。参数：query（字符串）。 | | get_class_source(class_name) | 返回给定类的完整反编译源代码。参数：class_name（完全限定类名，例如com.example.MyClass）。 | | search_method_by_name(method_name) | 搜索所有与提供的名称匹配的方法。返回类和方法对作为字符串。参数：method_name（字符串）。 | | get_methods_of_class(class_name) | 返回指定类中声明的所有方法名。参数：class_name（完全限定类名）。 | | get_fields_of_class(class_name) | 返回指定类中声明的所有字段名。参数：class_name（完全限定类名）。 | | get_method_code(class_name, method_name) | 仅返回类中特定方法的源代码块。参数：class_name（完全限定类名），method_name（字符串）。 | | get_method_signature(class_name, method_name) | 返回方法的完整签名，包括返回类型和参数。参数：class_name（完全限定类名），method_name（字符串）。 | | get_field_details(class_name, field_name) | 返回字段的详细信息，包括其类型和修饰符。参数：class_name（完全限定类名），field_name（字符串）。 | | search_method_by_return_type(return_type) | 按方法的返回类型搜索方法。参数：return_type（字符串）。 | | get_class_hierarchy(class_name) | 返回类的继承层次结构，包括其父类和接口。参数：class_name（完全限定类名）。 | | get_method_calls(class_name, method_name) | 返回特定方法中进行的所有方法调用。参数：class_name（完全限定类名），method_name（字符串）。 | | get_class_references(class_name) | 返回代码库中对特定类的所有引用。参数：class_name（完全限定类名）。 | | get_method_annotations(class_name, method_name) | 返回应用于特定方法的所有注解。参数：class_name（完全限定类名），method_name（字符串）。 | | get_tools_resource() | 从插件中返回所有可用工具及其描述的列表。 |

参数说明：

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功能： | API | 描述 | |-----|-------------| | decode_apk(apk_path, force, no_res, no_src) | 反编译APK文件，提取资源和smali代码。参数：apk_path（APK文件路径），force（强制覆盖），no_res（跳过资源），no_src（跳过源代码）。 | | build_apk(project_dir, output_apk, debug, force_all) | 从解码后的项目重新构建APK。参数：project_dir（项目路径），output_apk（输出路径），debug（包含调试信息），force_all（强制重新构建所有）。 | | clean_project(project_dir, backup) | 清理项目目录以准备重新构建。参数：project_dir（项目路径），backup（清理前创建备份）。 | | get_manifest(project_dir) | 从解码后的项目中获取AndroidManifest.xml内容。参数：project_dir（项目路径）。 | | find_leak_manifest(project_dir) | 在清单中查找没有权限限制的导出组件。参数：project_dir。 | | find_leak_components_source(project_dir, source_dirs) | 查找没有权限的导出组件并定位其源代码。参数：project_dir，source_dirs（源目录列表）。 | | list_smali_directories(project_dir) | 列出项目中的所有smali目录。参数：project_dir。 | | list_smali_files(project_dir, smali_dir, package_prefix) | 列出特定目录中的smali文件。参数：project_dir，smali_dir（默认："smali"），package_prefix（可选过滤器）。 | | get_smali_file(project_dir, class_name) | 获取特定smali文件的内容。参数：project_dir，class_name（完全限定类名）。 | | modify_smali_file(project_dir, class_name, new_content, create_backup) | 修改smali文件内容。参数：project_dir，class_name，new_content，create_backup（默认：True）。 | | list_resources(project_dir, resource_type) | 列出项目中的资源。参数：project_dir，resource_type（可选，例如"layout"，"drawable"）。 | | get_resource_file(project_dir, resource_type, resource_name) | 获取资源文件内容。参数：project_dir，resource_type，resource_name。 | | modify_resource_file(project_dir, resource_type, resource_name, new_content, create_backup) | 修改资源文件内容。参数：project_dir，resource_type，resource_name，new_content，create_backup（默认：True）。 | | search_in_files(project_dir, search_pattern, file_extensions, max_results) | 在项目文件中搜索。参数：project_dir，search_pattern，file_extensions（默认：[".smali", ".xml"]），max_results（默认：100）。 | | get_apktool_yml(project_dir) | 从解码后的项目中获取apktool.yml信息。参数：project_dir。 |

参数说明：

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 | 描述 | |-----|-------------| | uploadFile(file) | 将移动应用程序文件（APK、IPA或APPX）上传到MobSF进行安全分析。 | | getScanLogs(hash) | 检索先前分析的移动应用程序的详细扫描日志。 | | getJsonReport(hash) | 生成并检索JSON格式的全面安全分析报告。 | | getJsonReportSection(hash, section) | 获取JSON报告的特定部分。 | | getJsonReportSections(hash) | 获取JSON报告中所有可用的部分名称。 | | getRecentScans(page, pageSize) | 检索最近执行的安全扫描列表。 | | searchScanResult(query) | 按哈希、应用程序名称、包名或文件名搜索扫描结果。 | | deleteScan(hash) | 删除特定分析的扫描结果。 | | getScorecard(hash) | 获取MobSF应用程序安全计分卡。 | | generatePdfReport(hash) | 生成PDF安全报告（返回Base64编码的PDF）。 | | viewSource(hash, file, type) | 查看分析应用程序的源文件。 | | getScanTasks() | 获取扫描任务队列（需要启用异步扫描队列）。 | | compareApps(hash1, hash2) | 比较两个应用程序的安全分析结果。 | | suppressByRule(hash, type, rule) | 按规则ID抑制发现的问题。 | | suppressByFiles(hash, type, rule) | 按文件抑制发现的问题。 | | listSuppressions(hash) | 查看扫描的所有抑制项。 | | deleteSuppression(hash, type, rule, kind) | 删除特定的抑制项。 | | listAllHashes(page, pageSize) | 获取所有报告的MD5哈希值。 |

📊 报告部分API： MobSF提供了详细的特定部分API，用于访问分析报告的不同部分。每个部分可以使用getJsonSection_{section}(hash)进行访问： | 部分类别 | 可用部分 | |-----------------|-------------------| | 基本信息 | version，title，file_name，app_name，app_type，size，md5，sha1，sha256 | | 应用程序信息 | package_name，main_activity，version_name，version_code | | 组件 | exported_activities，browsable_activities，activities，receivers，providers，services | | SDK信息 | target_sdk，max_sdk，min_sdk，libraries | | 安全分析 | permissions，malware_permissions，certificate_analysis，manifest_analysis，network_security，binary_analysis | | 代码分析 | file_analysis，android_api，code_analysis，niap_analysis，permission_mapping | | 内容分析 | urls，domains，emails，strings，firebase_urls，secrets | | 附加信息 | exported_count，apkid，behaviour，trackers，playstore_details，sbom | | 安全指标 | average_cvss，appsec，virus_total | | 系统信息 | base_url，dwd_dir，host_os |

参数说明：

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

FlowDroid MCP

✨ 主要API功能： | API | 描述 | |-----|-------------| | run_flowdroid_analysis(apk_path, output_dir) | 对APK文件运行FlowDroid污点分析。参数：apk_path（APK文件路径），output_dir（可选输出目录）。 | | get_flowdroid_sources(analysis_dir) | 从FlowDroid分析结果中提取污点源。参数：analysis_dir（分析输出目录）。 | | get_flowdroid_sinks(analysis_dir) | 从FlowDroid分析结果中提取污点汇。参数：analysis_dir（分析输出目录）。 | | clean_flowdroid_workspace() | 清理FlowDroid工作区目录，为新的分析做准备。 |

参数说明：

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

多专家决策模型

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

分析过程概述

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

CrossValidation_APKAnalysis MCP

✨ 主要API功能： | API | 描述 | |-----|-------------| | analyze_with_jeb/jadx/apktool/flowdroid/mobsf(apk_path) | 使用JEB/JADX/APKTool/FlowDroid/MobSF MCP工具独立分析APK并生成标准化的漏洞报告。参数：apk_path（APK文件路径）。 | | combine_analysis_results(report_paths) | 合并所有5个工具的报告，统计每个漏洞的频率和来源，并按组件权重排序，生成初步的综合报告。参数：report_paths（报告文件路径列表）。 | | split_vulnerabilities_by_priority(combined_report_path) | 根据频率将漏洞分为三类：高优先级（前60%）、无MobSF来源的低优先级、仅含MobSF来源的低优先级，并分别保存。参数：combined_report_path（合并报告的路径）。 | | assess_vulnerability_risk(mobsf_low_priority_path) | 对于仅来自MobSF的低优先级漏洞，调用大模型进行风险评估，仅保留高风险漏洞。参数：mobsf_low_priority_path（仅含MobSF的低优先级漏洞的路径）。 | | integrate_priority_reports(high_priority_path, unique_low_priority_path, high_risk_mobsf_path) | 整合高优先级、独特低优先级和高风险的MobSF漏洞，生成最终的综合分析报告。参数：high_priority_path，unique_low_priority_path，high_risk_mobsf_path（每个报告的路径）。 |

参数说明：

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安全进行全面分析。具体技术细节如下：

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

📄 许可证

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

🙏 致谢

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

特别感谢：

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

⚠️ 免责声明和法律声明

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

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

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

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

🤝 贡献

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

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

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

apk-security-guard-mcp-suite

README

🚀 APK安全防护MCP套件

🚀 快速开始

环境依赖

安装步骤

插件或脚本安装建议

JEB MCP脚本

JADX MCP插件

APKTool

MobSF MCP

FlowDroid

VSCode Cline扩展配置

✨ 主要特性

📦 安装指南

依赖安装

插件或脚本安装

JEB MCP脚本

JADX MCP插件

APKTool

MobSF MCP

FlowDroid

VSCode Cline扩展配置

📚 详细文档

API文档

JEB MCP

JADX MCP

APKTool MCP

MobSF MCP

FlowDroid MCP

多专家决策模型

分析过程概述

CrossValidation_APKAnalysis MCP

VSCode Cline扩展配置

🔧 技术细节

📄 许可证

🙏 致谢

⚠️ 免责声明和法律声明

🤝 贡献

Runtime guide

Hosted runtime

Local runtime / other methods