Mobsf MCP

🚀 MobSF-MCP

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

🚀 快速开始

前提条件

• Node.js（v14或更高版本）
• npm（Node包管理器）
• 运行中的MobSF实例，并具备API访问权限

安装与使用

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

npm install -g mobsf-mcp

配置环境变量，并使用npx命令启动MobSF MCP服务器：

📚 以管理员身份打开PowerShell

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

✨ 主要特性

• 提供标准化接口，便于将MobSF的安全分析能力集成到自动化工作流和第三方工具中。
• 支持多种API端点，可满足不同的安全分析需求。

📦 安装指南

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

npm install -g mobsf-mcp

配置环境变量，并使用npx命令启动MobSF MCP服务器：

📚 以管理员身份打开PowerShell

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

💻 使用示例

基础用法

以下是使用uploadFile端点上传移动应用文件进行安全分析的示例：

# 假设使用curl进行API调用
curl -X POST -F "file=@/path/to/your/app.apk" http://localhost:3000/uploadFile

高级用法

使用getJsonReport端点获取完整的JSON安全分析报告：

curl -X GET http://localhost:3000/getJsonReport?hash=your_scan_md5_hash

📚 详细文档

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