Apktool MCP

🚀 Apktool MCP Server

この強力なModel Context Protocol (MCP)サーバーは、Android APKの分析とリバースエンジニアリングのためにApktoolの機能を公開します。Gemini CLIとシームレスに統合され、自然言語コマンドを通じてAIによるAPKのセキュリティ分析、プライバシー監査、およびリバースエンジニアリングのガイダンスを提供します。

🚀 クイックスタート

このセクションでは、Apktool MCP Serverのインストールと基本的な使い方を説明します。

✨ 主な機能

🔍 包括的なAPK分析

• APKをデコンパイルして、リソース、マニフェスト、およびsmaliコードを抽出します。
• パーミッションとアプリコンポーネントを分析して、セキュリティ評価を行います。
• 文字列リソースを抽出し、ハードコードされたシークレットを検出します。
• smaliコードを検索して、特定のパターンとセキュリティ脆弱性を見つけます。
• 変更後のAPKを再コンパイルします。

🤖 AIによるワークフロー

• 自然言語コマンドを使用して、複雑なAPK分析タスクを実行します。
• AIによる自動セキュリティ監査と洞察を提供します。
• プライバシーコンプライアンスチェックとGDPR/CCPA分析を行います。
• ステップバイステップのリバースエンジニアリングガイダンスを提供します。
• インテリジェントな脆弱性検出とリスク評価を行います。

🛠 8つのコアツール

📋 特殊な分析プロンプト

• セキュリティ分析: 包括的な脆弱性評価を行います。
• プライバシー監査: データ収集とコンプライアンス分析を行います。
• リバースエンジニアリングガイド: ステップバイステップの分析ワークフローを提供します。

📦 インストール

前提条件

1. Java JDK 8+ (Apktoolが必要とするもの)

# Ubuntu/Debian
sudo apt update && sudo apt install default-jdk

# macOS (Homebrew)
brew install openjdk

# インストールの確認
java -version

2. Apktool (コア依存関係)

# オプション1: パッケージマネージャー (推奨)
# Ubuntu/Debian
sudo apt install apktool

# macOS
brew install apktool

# オプション2: 手動インストール
# https://ibotpeaches.github.io/Apktool/install/ からダウンロード

# インストールの確認
apktool --version

3. Python 3.10+

python3 --version  # 3.10以上である必要があります

セットアップ手順

1. リポジトリをクローン

git clone https://github.com/SecFathy/APktool-MCP.git
cd APktool-MCP

2. 仮想環境を作成

python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# または
venv\Scripts\activate     # Windows

3. 依存関係をインストール

pip install -r requirements.txt

4. インストールをテスト

python3 apktool_server.py
# MCPサーバーが正常に起動するはずです

⚙️ 設定

Gemini CLIとの統合

1. Gemini CLIをインストール

# https://github.com/google-gemini/gemini-cli の手順に従ってください

2. MCPサーバーを設定

Gemini CLIの設定ファイルを編集します。

• Linux/macOS: ~/.config/gemini-cli/config.json
• Windows: %APPDATA%\gemini-cli\config.json

{
  "mcpServers": {
    "apktool": {
      "command": "python3",
      "args": ["/absolute/path/to/apktool_server.py"],
      "env": {
        "APKTOOL_WORK_DIR": "/path/to/workspace"
      }
    }
  }
}

Claude Desktopとの統合 (代替案)

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

{
  "mcpServers": {
    "apktool": {
      "command": "python3",
      "args": ["/absolute/path/to/apktool_server.py"],
      "env": {
        "APKTOOL_WORK_DIR": "/path/to/workspace"
      }
    }
  }
}

💻 使用例

自然言語コマンド

# Gemini CLIを起動
gemini

# セキュリティ分析
> "Analyze the APK at ./suspicious_app.apk for security vulnerabilities"

# パーミッション分析
> "What permissions does ./myapp.apk request and are any of them dangerous?"

# コード分析
> "Find any hardcoded API keys or secrets in ./social_app.apk"

# プライバシー監査
> "Generate a privacy compliance report for ./messenger_app.apk"

# リバースエンジニアリング
> "Help me understand how the authentication works in ./banking_app.apk"

直接のツール使用

# APKをデコンパイル
> Use decode_apk to decompile ./sample.apk

# パーミッションを分析
> Use list_permissions on the decompiled directory ./sample

# パターンを検索
> Use find_smali_references to search for "crypto" in ./sample

# 文字列を抽出
> Use extract_strings from ./sample for locale "en"

# APKを再構築
> Use build_apk to recompile ./sample into ./sample_modified.apk

ガイド付きワークフロー

# 自動セキュリティ分析を実行
> Run the security analysis prompt on ./target_app.apk

# プライバシー監査を実行
> Execute privacy audit workflow for ./social_media_app.apk

# リバースエンジニアリングのガイダンスを取得
> Use the reverse engineering guide for analyzing login functionality in ./app.apk

📚 ドキュメント

プロジェクト構造

apktool-mcp-server/
├── apktool_server.py          # 主要なMCPサーバーの実装
├── requirements.txt           # Pythonの依存関係
├── config.json               # 例となるGemini CLIの設定
├── README.md                 # このファイル
├── GEMINI.md                 # AIアシスタントのコンテキストファイル
├── LICENSE                   # MITライセンス
├── examples/                 # 使用例とサンプル
│   ├── sample_analysis.py    # 例となる分析スクリプト
│   └── workflows/            # 一般的なワークフローの例
├── tests/                    # 単体テスト
│   ├── test_server.py        # サーバー機能のテスト
│   └── test_tools.py         # 個々のツールのテスト
└── docs/                     # 追加のドキュメント
    ├── SECURITY.md           # セキュリティガイドライン
    ├── CONTRIBUTING.md       # コントリビューションガイドライン
    └── TROUBLESHOOTING.md    # 一般的な問題と解決策

🔧 技術詳細

セキュリティに関する考慮事項

⚠️ 重要なセキュリティ注意事項

• 法的コンプライアンス: 自分が所有するか、明示的な許可を得たAPKのみを分析してください。
• マルウェアリスク: 不明なAPKには悪意のあるコードが含まれている可能性があります - 隔離された環境で使用してください。
• データプライバシー: デコンパイルされたAPKには敏感なユーザー情報が含まれている可能性があります。
• ワークスペースの隔離: 制限付きのパーミッションを持つ専用のワークスペースを設定してください。
• プロセス制限: サーバーにはタイムアウトが設定されており、リソースの枯渇を防ぎます。

ベストプラクティス

# 専用のワークスペースを使用
export APKTOOL_WORK_DIR="/secure/isolated/workspace"

# 適切なパーミッションを設定
chmod 750 /secure/isolated/workspace

# リソース使用量を監視
htop  # 分析中のメモリとCPUを監視

# 分析後にクリーンアップ
rm -rf /secure/isolated/workspace/*

テスト

単体テストの実行

# テスト依存関係をインストール
pip install pytest pytest-asyncio

# すべてのテストを実行
pytest tests/

# カバレッジ付きで実行
pytest --cov=apktool_server tests/

手動テスト

# サーバーの起動をテスト
python3 apktool_server.py

# サンプルAPKでテスト
# サンプルAPKをダウンロードして基本機能をテスト

統合テスト

# Gemini CLIの統合をテスト
gemini
> /tools  # apktoolのツールがリストされるはずです
> Use decode_apk to analyze sample.apk

🤝 コントリビューション

私たちはコントリビューションを歓迎します！詳細については CONTRIBUTING.md を参照してください。

開発環境のセットアップ

# クローンして開発環境をセットアップ
git clone https://github.com/SecFathy/APktool-MCP.git
cd APktool-MCP
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
pip install -r requirements-dev.txt

# テストを実行
pytest

# コードをフォーマット
black apktool_server.py

📄 ライセンス

このプロジェクトは MITライセンス の下でライセンスされています。