Mobsf MCP

🚀 MobSF-MCP

MobSF MCPは、モバイルセキュリティフレームワーク（MobSF）用の、Node.jsベースのモデルコンテキストプロトコルの実装です。MobSFのセキュリティ分析機能を自動化ワークフローやサードパーティツールに統合するための標準化されたインターフェースを提供します。

🚀 クイックスタート

このアーキテクチャはhttps://github.com/GH05TCREW/mobsf-mcpに基づいています。

✨ 主な機能

MobSF MCPは、モバイルセキュリティフレームワーク（MobSF）のセキュリティ分析機能を自動化ワークフローやサードパーティツールに統合するための標準化されたインターフェースを提供します。

📦 インストール

前提条件

• Node.js (v14以上)
• npm (Node Package Manager)
• APIアクセス可能なMobSFの実行インスタンス

インストール手順

リポジトリをクローンするか、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

💻 使用例

基本的な使用法

以下のコマンドを使用して、依存関係をインストールし、サーバーを起動します。

npm install -g mobsf-mcp
$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ファイルを参照してください。

✨ 謝辞

• Mobile Security Framework (MobSF)
• gc-mobsf-mcp