Frida MCP

Frida MCP

Frida 動的計装ツールキット用の Model Context Protocol（MCP）実装です。

概要

このパッケージは、Frida の動的計装機能を通じて AI システムがモバイルアプリやデスクトップアプリと連携できる、MCP 準拠のサーバーを提供します。公式の MCP Python SDK を使用し、AI アプリケーションとシームレスに統合できます。

デモ

https://github.com/user-attachments/assets/5dc0e8f5-5011-4cf2-be77-6a77ec960501

機能

• 公式の MCP Python SDK で構築
• MCP を通じて公開される包括的な Frida ツール：
  • プロセス管理（一覧表示、アタッチ、起動、再開、終了）
  • デバイス管理（USB、リモートデバイス）
  • リアルタイム実行に対応した対話型 JavaScript REPL
  • 進行状況の追跡に対応したスクリプトのインジェクション
  • プロセスとデバイスの監視
• モデルに Frida データを提供するリソース
• Frida 分析ワークフローをガイドするプロンプト
• 長時間実行される操作の進行状況を追跡
• すべての MCP トランスポート方式を完全サポート

インストール

前提条件

• Python 3.8 以降
• pip パッケージマネージャー
• Frida 16.0.0 以降

クイックインストール

pip install frida-mcp

開発用インストール

# Clone the repository
git clone https://github.com/yourusername/frida-mcp.git
cd frida-mcp

# Install in development mode with extra tools
pip install -e ".[dev]"

Claude Desktop との連携

Frida MCP を Claude Desktop で使用するには、Claude の設定ファイルを更新する必要があります。

1. Claude Desktop の設定ファイルを確認します。

   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

2. 設定ファイルに以下を追加します。

{
  "mcpServers": {
    "frida": {
      "command": "frida-mcp"
    }
  }
}

使用方法

インストール後、Claude Desktop から Frida MCP を直接使用できます。サーバーは以下の機能を提供します。

プロセス管理

• 実行中のプロセスをすべて一覧表示
• 特定のプロセスにアタッチ
• 新しいプロセスを起動
• 中断中のプロセスを再開
• プロセスを終了

デバイス管理

• 接続中のデバイス（USB、リモート）をすべて一覧表示
• デバイス情報を取得
• 特定のデバイスに接続

対話型 JavaScript REPL

• プロセスとの対話型セッションを作成
• JavaScript コードをリアルタイムで実行
• プロセスの状態とメモリを監視
• 関数をフックして呼び出しをインターセプト
• console.log の出力を取得
• エラーや例外を適切に処理

スクリプトのインジェクション

• カスタム JavaScript スクリプトをインジェクト
• インジェクションの進行状況を追跡
• スクリプトのエラーや例外を処理

リソース

• Frida のバージョン情報を取得
• 人が読みやすい形式でプロセス一覧にアクセス
• 人が読みやすい形式でデバイス一覧にアクセス

開発

# Clone repository
git clone https://github.com/yourusername/frida-mcp.git
cd frida-mcp

# Install development dependencies
pip install -e ".[dev]"

ライセンス

MIT