JinDaGe - mobsf-mcp MCP Details

article

README

🚀 MobSF-MCP

MobSF MCP是基于Node.js的模型上下文协议实现，专为移动安全框架（MobSF）打造。它提供了标准化接口，可将MobSF的安全分析能力集成到自动化工作流和第三方工具中。

🚀 快速开始

MobSF MCP是一个基于Node.js的模型上下文协议实现，用于移动安全框架（MobSF）。它为将MobSF的安全分析功能集成到自动化工作流和第三方工具中提供了标准化接口。

✨ 主要特性

提供标准化接口，便于将MobSF安全分析能力集成到自动化工作流和第三方工具。
支持多种API接口，可进行文件上传、扫描日志获取、报告生成等操作。

📦 安装指南

安装依赖

克隆仓库或导航到mobsf-mcp目录，然后安装依赖：

npm install -g mobsf-mcp

配置环境变量并启动服务器

以管理员身份打开PowerShell，然后执行以下命令：

$env:MOBSF_URL="http://localhost:8000"; 
$env:MOBSF_API_KEY="your_api_key_here"; 
npx mobsf-mcp

📚 详细文档

📂 API参考

可用端点

| 端点 | 描述 | 参数 | |------|-------------|------------| | uploadFile | 上传移动应用文件（APK、IPA或APPX）进行安全分析 | file：要上传的文件路径 | | getScanLogs | 获取已分析应用的详细扫描日志 | hash：扫描的MD5哈希值 | | getJsonReport | 获取完整的JSON安全分析报告 | hash：扫描的MD5哈希值 | | getJsonReportSection | 获取报告的特定部分 | hash：MD5哈希值，section：部分名称 | | getJsonReportSections | 列出所有可用的报告部分 | hash：扫描的MD5哈希值 | | getRecentScans | 获取最近的安全扫描列表 | page：页码，pageSize：每页结果数 | | searchScanResult | 根据各种条件搜索扫描结果 | query：搜索词（哈希/名称/包名） | | deleteScan | 删除扫描结果 | hash：扫描的MD5哈希值 | | getScorecard | 获取应用安全评分卡 | hash：扫描的MD5哈希值 | | generatePdfReport | 生成PDF安全报告 | hash：扫描的MD5哈希值 | | viewSource | 查看分析中的源文件 | hash：MD5哈希值，file：文件路径，type：文件类型 | | getScanTasks | 获取扫描任务队列（异步扫描队列） | 无 | | compareApps | 比较两个扫描结果 | hash1：第一次扫描的哈希值，hash2：第二次扫描的哈希值 | | suppressByRule | 按规则ID抑制发现结果 | hash：MD5哈希值，type：代码/清单，rule：规则ID | | suppressByFiles | 按文件抑制发现结果 | hash：MD5哈希值，type：代码，rule：规则ID | | listSuppressions | 查看扫描抑制情况 | hash：扫描的MD5哈希值 | | deleteSuppression | 删除抑制设置 | hash：MD5哈希值，type：代码/清单，rule：规则ID，kind：规则/文件 | | listAllHashes | 获取所有报告的MD5哈希值 | page：页码，pageSize：每页结果数 |

JSON报告部分

使用getJsonReportSection时，可获取以下部分：

基本信息

version：MobSF版本
title：报告标题
file_name：分析的文件名
app_name：应用名称
app_type：应用类型
size：文件大小
md5、sha1、sha256：文件哈希值
package_name：应用包名

应用组件

main_activity：主活动名称
exported_activities：导出活动列表
browsable_activities：可浏览活动列表
activities：所有活动
receivers：广播接收器
providers：内容提供者
services：服务
libraries：原生库

安全分析

target_sdk、max_sdk、min_sdk：SDK版本
version_name、version_code：应用版本信息
permissions：声明的权限
malware_permissions：潜在危险权限
certificate_analysis：证书安全分析
manifest_analysis：AndroidManifest.xml分析
network_security：网络安全配置
binary_analysis：二进制文件分析
code_analysis：源代码安全分析
niap_analysis：NIAP合规性分析

额外分析

permission_mapping：权限使用映射
urls、domains、emails：提取的字符串
firebase_urls：Firebase URL分析
exported_count：导出组件数量
apkid：APK标识符信息
behaviour：应用行为分析
trackers：跟踪库检测
playstore_details：Google Play商店详情
secrets：检测到的秘密/密钥
logs：分析日志
sbom：软件物料清单
average_cvss：平均CVSS分数
appsec：应用安全分数
virus_total：VirusTotal扫描结果

🖥️ VSCode Cline扩展配置

要在VSCode中使用cline扩展与本项目配合使用，请在cline配置文件中添加以下配置：

{
  "mcpServers": {
    "MobSF MCP Server": {
      "disabled": false,
      "timeout": 60,
      "command": "Nodejs\\node.exe",
      "args": [
        "index.js"
      ],
      "env": {
        "MOBSF_URL": "http://localhost:8000",
        "MOBSF_API_KEY": "your_api_key_here"
      },
      "transportType": "stdio"
    }
  }
}

⚠️ 重要提示

请根据您的系统调整Node.js可执行文件的路径（例如C:\\Program Files\\nodejs\\node.exe），并确保在配置中填写实际的MOBSF_API_KEY。

⚠️ 免责声明和法律声明

本工具专为安全研究人员、渗透测试人员和开发人员设计，仅用于合法用途。其主要目的在于协助进行以下工作：

对您自己的应用程序进行安全评估。
对您已获得明确测试许可的应用程序进行测试。
用于研究和教育目的。

严禁进行以下使用：

任何恶意或有害活动。
未经授权访问系统或数据。
在未获得适当授权的情况下测试应用程序。
任何非法活动或违反法律的行为。

使用本工具即表示您同意：

仅将其用于合法和授权目的。
对自己的行为承担全部责任。
遵守所有适用的法律法规。
使开发者和贡献者免受任何索赔。

📄 许可证

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

mobsf-mcp