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