Mobsf MCP

🚀 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参考

可用端点

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。

⚠️ 免责声明和法律声明

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

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

严禁进行以下使用：

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

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

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

📄 许可证

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

✨ 致谢

• 移动安全框架（MobSF）
• gc-mobsf-mcp