Skip to main content
Glama
MobSF MCP Server
by il-il1

MobSF-MCP

Architecture based on https://github.com/GH05TCREW/mobsf-mcp

📑 Overview

MobSF MCP is a Node.js-based Model Context Protocol implementation for Mobile Security Framework (MobSF). It provides a standardized interface for integrating MobSF's security analysis capabilities into automated workflows and third-party tools.

Related MCP server: Binalyze AIR MCP Server

🛠️ Prerequisites

  • Node.js (v14 or higher)

  • npm (Node Package Manager)

  • Running instance of MobSF with API access


⚙️ Installation And Usage

Clone the repository or navigate to the mobsf-mcp directory, and install dependencies:

npm install -g mobsf-mcp

Configure environment variables and start the MobSF MCP server by using the npx command:

📚 Open PowerShell as an administrator

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

📂 API Reference

Available Endpoints

Endpoint

Description

Parameters

uploadFile

Upload a mobile application file (APK, IPA, or APPX) for security analysis

file: File path to upload

getScanLogs

Retrieve detailed scan logs for analyzed application

hash: MD5 hash of the scan

getJsonReport

Get full JSON security analysis report

hash: MD5 hash of the scan

getJsonReportSection

Get specific section of the report

hash: MD5 hash, section: Section name

getJsonReportSections

List all available report sections

hash: MD5 hash of the scan

getRecentScans

Retrieve list of recent security scans

page: Page number, pageSize: Results per page

searchScanResult

Search scan results by various criteria

query: Search term (hash/name/package)

deleteScan

Delete scan results

hash: MD5 hash of the scan

getScorecard

Get application security scorecard

hash: MD5 hash of the scan

generatePdfReport

Generate PDF security report

hash: MD5 hash of the scan

viewSource

View source files from analysis

hash: MD5 hash, file: File path, type: File type

getScanTasks

Get scan tasks queue (async scan queue)

None

compareApps

Compare two scan results

hash1: First scan hash, hash2: Second scan hash

suppressByRule

Suppress findings by rule ID

hash: MD5 hash, type: code/manifest, rule: Rule ID

suppressByFiles

Suppress findings by files

hash: MD5 hash, type: code, rule: Rule ID

listSuppressions

View scan suppressions

hash: MD5 hash of the scan

deleteSuppression

Delete suppressions

hash: MD5 hash, type: code/manifest, rule: Rule ID, kind: rule/file

listAllHashes

Get all report MD5 hash values

page: Page number, pageSize: Results per page

JSON Report Sections

The following sections are available when using getJsonReportSection:

Basic Information

  • version: MobSF version

  • title: Report title

  • file_name: Analyzed file name

  • app_name: Application name

  • app_type: Application type

  • size: File size

  • md5, sha1, sha256: File hashes

  • package_name: Application package name

Application Components

  • main_activity: Main activity name

  • exported_activities: List of exported activities

  • browsable_activities: List of browsable activities

  • activities: All activities

  • receivers: Broadcast receivers

  • providers: Content providers

  • services: Services

  • libraries: Native libraries

Security Analysis

  • target_sdk, max_sdk, min_sdk: SDK versions

  • version_name, version_code: App version info

  • permissions: Declared permissions

  • malware_permissions: Potentially dangerous permissions

  • certificate_analysis: Certificate security analysis

  • manifest_analysis: AndroidManifest.xml analysis

  • network_security: Network security configuration

  • binary_analysis: Binary file analysis

  • code_analysis: Source code security analysis

  • niap_analysis: NIAP compliance analysis

Additional Analysis

  • permission_mapping: Permission usage mapping

  • urls, domains, emails: Extracted strings

  • firebase_urls: Firebase URL analysis

  • exported_count: Count of exported components

  • apkid: APK identifier information

  • behaviour: Application behavior analysis

  • trackers: Tracking libraries detection

  • playstore_details: Google Play Store details

  • secrets: Detected secrets/keys

  • logs: Analysis logs

  • sbom: Software Bill of Materials

  • average_cvss: Average CVSS score

  • appsec: Application security score

  • virus_total: VirusTotal scan results

🖥️ VSCode Cline Extension Configuration

To use this project with the cline extension in VSCode, add the following configuration to your cline configuration file:

{
  "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"
    }
  }
}

⚠️ Path to your Node.js executable (adjust according to your system, e.g., C:\\Program Files\\nodejs\\node.exe). Make sure to fill in your actual MOBSF_API_KEY in the configuration.

This tool is designed and provided for security researchers, penetration testers, and developers for LEGAL USE ONLY. The primary purpose is to assist in:

  • Security assessment of your own applications

  • Applications you have explicit permission to test

  • Research and educational purposes

The following uses are strictly prohibited:

  • Any malicious or harmful activities

  • Unauthorized access to systems or data

  • Testing applications without proper authorization

  • Any illegal activities or violation of laws

By using this tool, you agree to:

  1. Use it only for legal and authorized purposes

  2. Take full responsibility for your actions

  3. Comply with all applicable laws and regulations

  4. Hold the developers and contributors harmless from any claims

📄 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

✨ Acknowledgments

Available Tools

71 tools
compareAppsC

Compare scan results by two hashes.

Inputs: hash1 (required), hash2 (required).

deleteScanA

Delete scan results by hash.

Inputs: hash (required).

deleteSuppressionC

Delete suppressions.

Inputs: hash (required), type (required), rule (required), kind (required).

generatePdfReportA

Generate PDF security report by hash. Returns PDF as base64 string.

Inputs: hash (required).

getJsonReportA

Generate and retrieve a comprehensive security analysis report in JSON format for a scanned mobile application. This report includes detailed findings about security vulnerabilities, permissions, API calls, and other security-relevant information.

Inputs: hash (required).

getJsonReportSectionC

Get a specific section of the MobSF JSON report by hash and section name.

Inputs: hash (required), section (required).

getJsonReportSectionsA

Get all top-level section names of the MobSF JSON report.

Inputs: hash (required).

getJsonSection_activitiesB

Get the 'activities' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_android_apiB

Get the 'android_api' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_apkidA

Get the 'apkid' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_app_nameA

Get the 'app_name' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_appsecA

Get the 'appsec' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_app_typeB

Get the 'app_type' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_average_cvssB

Get the 'average_cvss' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_base_urlB

Get the 'base_url' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_behaviourA

Get the 'behaviour' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_binary_analysisB

Get the 'binary_analysis' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_browsable_activitiesA

Get the 'browsable_activities' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_certificate_analysisA

Get the 'certificate_analysis' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_code_analysisB

Get the 'code_analysis' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_domainsB

Get the 'domains' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_dwd_dirC

Get the 'dwd_dir' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_emailsB

Get the 'emails' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_exported_activitiesB

Get the 'exported_activities' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_exported_countA

Get the 'exported_count' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_file_analysisB

Get the 'file_analysis' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_file_nameB

Get the 'file_name' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_firebase_urlsC

Get the 'firebase_urls' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_host_osA

Get the 'host_os' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_librariesB

Get the 'libraries' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_logsB

Get the 'logs' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_main_activityC

Get the 'main_activity' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_malware_permissionsA

Get the 'malware_permissions' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_manifest_analysisA

Get the 'manifest_analysis' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_max_sdkA

Get the 'max_sdk' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_md5C

Get the 'md5' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_min_sdkA

Get the 'min_sdk' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_network_securityA

Get the 'network_security' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_niap_analysisB

Get the 'niap_analysis' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_package_nameB

Get the 'package_name' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_permission_mappingA

Get the 'permission_mapping' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_permissionsA

Get the 'permissions' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_playstore_detailsA

Get the 'playstore_details' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_providersB

Get the 'providers' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_receiversC

Get the 'receivers' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_sbomB

Get the 'sbom' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_secretsA

Get the 'secrets' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_servicesB

Get the 'services' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_sha1B

Get the 'sha1' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_sha256A

Get the 'sha256' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_sizeA

Get the 'size' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_stringsA

Get the 'strings' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_target_sdkB

Get the 'target_sdk' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_titleC

Get the 'title' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_trackersA

Get the 'trackers' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_urlsC

Get the 'urls' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_versionB

Get the 'version' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_version_codeA

Get the 'version_code' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_version_nameA

Get the 'version_name' section of the MobSF JSON report by hash.

Inputs: hash (required).

getJsonSection_virus_totalA

Get the 'virus_total' section of the MobSF JSON report by hash.

Inputs: hash (required).

getRecentScansB

Retrieve a list of recently performed security scans on the MobSF server, showing mobile applications that have been analyzed, their statuses, and basic scan information.

Inputs: page (required), pageSize (required).

getScanLogsA

Retrieve detailed scan logs for a previously analyzed mobile application using its hash value. These logs contain information about the scanning process and any issues encountered.

Inputs: hash (required).

getScanTasksA

Get scan tasks queue (async scan queue must be enabled).

Inputs: no named parameters.

getScorecardB

Get MobSF Application Security Scorecard by hash.

Inputs: hash (required).

listAllHashesC

Get all report MD5 hash values.

Inputs: page (required), pageSize (required).

listSuppressionsC

View suppressions associated with a scan.

Inputs: hash (required).

searchScanResultB

Search scan results by hash, app name, package name, or file name.

Inputs: query (required).

suppressByFilesC

Suppress findings by files.

Inputs: hash (required), type (required), rule (required).

suppressByRuleB

Suppress findings by rule id.

Inputs: hash (required), type (required), rule (required).

uploadFileA

Upload a mobile application file (APK, IPA, or APPX) to MobSF for security analysis. This is the first step before scanning and must be done prior to using other analysis functions.

Inputs: file (required).

viewSourceC

View source files by hash, file path, and type.

Inputs: hash (required), file (required), type (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.7/5.0

    Scored across 71 tools

    Disambiguation2/5

    The sheer number of getJsonSection_* tools (52) makes it difficult for an agent to distinguish between them; they all perform the same operation on different sections. Additionally, tools like getJsonReport and getJsonReportSection overlap, causing ambiguity.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (e.g., uploadFile, deleteScan, getJsonSection_*). However, a few like getJsonReportSections and getJsonReportSection break the precise schema, and compareApps uses a verb phrase.

    Tool Count1/5

    71 tools is excessively high for a mobile security scanner. The majority are redundant getJsonSection_* tools that could be replaced by a single parameterized tool, drastically reducing the count. Tools like listAllHashes and getScanTasks add little value.

    Completeness2/5

    The tool set lacks essential operations like starting a scan (scanFile), which is critical for the workflow. Reporting is over-covered, but lifecycle management (update, re-analyze) is missing. There are no tools for dynamic analysis or interacting with scan progress.

    Related MCP Connectors

    Related MCP Servers