Frida C2 MCP

🚀 FridaC2MCP

Fridaの強力な動的インストルメンテーション機能をシンプルなリモートサーバーとして公開する、ストリーミング可能なHTTPトランスポートを備えたMCPサーバーの概念実証です。

このプロジェクトは、ルート化されたAndroidデバイス（例：Termux内）で直接実行するように設計されており、リモートクライアントがネットワークを介して実行中のアプリケーションを分析および操作できるようにします。 これは橋渡しの役割を果たし、Fridaの機能をHTTPリクエストで呼び出せるツールに変え、自動化されたエージェントベースのモバイルセキュリティテストを可能にすることを目的としています。

https://github.com/user-attachments/assets/7cee77c5-ed40-4797-b6b5-3edb5fdd03ce

🚀 クイックスタート

このプロジェクトは、ルート化されたAndroidデバイスで直接実行することができ、リモートクライアントがネットワークを介して実行中のアプリケーションを分析および操作できるようにします。

✨ 主な機能

• プロセスとアプリケーションの管理：インストールされたアプリケーションをリストアップし、実行中のプロセスを列挙し、フォアグラウンドのアプリケーションに関する情報を取得します。
• アプリケーションの制御：識別子またはPIDによってアプリケーションを起動および終了します。
• 動的インストルメンテーション：実行中のプロセスにアタッチしてインタラクティブなセッションを作成します。
• リモートスクリプト実行：アタッチされたセッション内でカスタムFrida（JavaScript）スクリプトを実行します。スクリプトは、最新のFridaバージョンとの互換性を確保するために、esbuildを使用してオンザフライでバンドルされます。これは、一時的なスクリプトと永続的なフック（keep_alive=True）の両方をサポートします。

📚 ドキュメント

想定されるユースケース

このプロジェクトの主な目的は、リモートおよび自動化されたモバイルアプリケーションのセキュリティテストを容易にすることです。FridaをMCPサーバーとして公開することで、ペンテスターまたは自動化エージェント（LLMなど）は、初期設定後に直接のUSB接続やローカルシェルアクセスを必要とせずに、アプリケーションの動作を検査および変更することができます。クライアントは、すべてのFridaツールがターゲットデバイスに含まれているため、Fridaツールをインストールする必要はありません。

典型的なユースケースは次のとおりです。

1. デバイス上でターゲットアプリケーションをリモートで起動します。
2. アプリケーションにFridaセッションをアタッチします。
3. JavaScriptフックを注入して、セキュリティコントロール（例：owasp.sat.agoatのルート検出チェック）をバイパスします。
4. アプリケーションの動作の変化を観察します。

アーキテクチャと設計の理由

このシステムは、クライアント - サーバーモデルで動作し、独自のデバイス上実行環境を可能にするための特定の設計選択がなされています。

• サーバー (cli.py)：FastMCPとasyncioを使用したPythonスクリプトです。これはAndroidデバイス自体で実行され、HTTPリクエストを待ち受け、それをFridaコマンドに変換します。
• クライアント：任意のHTTPクライアントがサーバーとやり取りできます。このプロジェクトは、5ireのようなツールを念頭に設計されており、生成AIエージェントがインストルメントされたデバイスとやり取りできるようになっています。
• ストリーミング可能なHTTPトランスポート：サーバーは、単純なstdioベースのトランスポートではなく、ストリーミング可能なHTTPトランスポートを使用しています。これは、複数の同時接続を可能にし、複数のデバイス間でのより複雑なエージェント間（A2A）通信シナリオのための道を開くための意図的な選択です。
• esbuildによるデバイス上のスクリプトバンドリング：Fridaバージョン17以降では、JavaScriptを最小化またはバンドルする必要があります。frida-compileをAndroidで直接実行することは困難であるため、このプロジェクトでは軽量な代替手段としてesbuildを使用しています。サーバーは、JSコードを一時ファイルに書き込み、esbuildでバンドルし、結果をターゲットプロセスにロードするプロセスを自動的に処理します。
• 手動でコンパイルされたFridaバージョン：このプロジェクトは現在、デバイス上で最新のFridaクライアントを手動でコンパイルする必要があります。これは、frida-pythonライブラリのCバインディングが不安定なためです。回避策として、frida-coreに関連付けられた内部ツールチェーンを手動で乗っ取り、Termuxネイティブのツールを供給しています。

ロードマップと進捗状況

Android

• ネイティブツールのアップグレード：Fridaの手動ビルド手法があるため、esbulidを削除し、Frida上にfrida-toolsをインストールすることができます。そうすることで、esbuildの代わりにfrida-compileを使用できるようになり、よりクリーンなビルドをリリースする予定です。これにより、デバイス上で好きなFridaツールをすべて呼び出すことができますXD

iOS

• iOSのルートレスジェイルブレイクサポート：コンパイラの地獄に突入しましたが、iOS 16.7.12を実行しているルートレスジェイルブレイクされたiPhone Xでテストした（ほぼ）動作するバージョンが、ほぼリリース準備ができています！:3
• Python3.12：これには、カスタムコンパイルされたPython 3.12が含まれます。これは、Procursusリポジトリではまだ利用できないバージョンです。また、ルートレス環境用に特別にパッチが当てられた一連のカスタムコンパイルされたPythonパッケージも含まれています。これは、私の考えでは、fastmcpの完全な機能をiOSに持ち込むために必要でした。
• ノードレス設計：Node.jsは必要ありません。オンザフライコンパイルには（のみ）ObjCをサポートします。

謝辞

このプロジェクトは、Daniel Nakovによる元のFridaMCPのネットワーク化された進化版です。元のプロジェクトがstdioを介したFridaのMCPサーバーとしての使用を先駆けた一方で、FridaC2MCPは、ストリーミング可能なHTTPと最新のFrida 17バンドリングを使用して、この概念をリモートのマルチデバイスC2環境に適応させています。

⚠️ 免責事項と将来の計画

これは草案であり、概念実証です。適切なセッション管理、エラーハンドリング、そして最も重要なことに、あらゆる形態のセキュリティが欠けています。すべての通信は暗号化されておらず、認証もされていません。自己責任で使用してください。また、安全で孤立したネットワーク環境でのみ使用してください。

将来の計画には、セッション管理の改善、セキュリティ対策の実装、および潜在的にiOSへのサポート拡張が含まれます。