MCP Adb

🚀 ADB MCP Server (Python)

Pythonで実装されたMCP（Model Context Protocol）サーバーです。これにより、ClaudeはAndroid Debug Bridge（ADB）を介してAndroidデバイスと直接通信できます。

🚀 主な機能

• デバイス管理：接続されているデバイスを一覧表示
• コマンド実行：Androidでシェルコマンドを実行
• アプリのインストール/アンインストール：デバイス上のアプリを管理
• ログの取得：Androidのlogcatにアクセス
• スクリーンショット：デバイスの画面をキャプチャ
• ファイルの転送：ファイルのプッシュ/プル
• 入力のシミュレーション：タップ、スワイプ、文字入力
• アプリの一覧表示：インストールされているアプリを確認
• システム情報：バッテリー、バージョン、モデル、メモリの情報を取得

📋 前提条件

1. Python 3.10以上
2. uv（Pythonパッケージマネージャー）
3. C:\Users\Cristiano\Programação\ADB\にインストールされたADB（Android Debug Bridge）
4. USBデバッグが有効になっているAndroidデバイス
5. MCPをサポートするClaude Desktop

🛠️ インストール

1. uvをインストールする（未インストールの場合）

# Windows (PowerShell)
irm https://astral.sh/uv/install.ps1 | iex

# または公式サイトからダウンロード: https://github.com/astral-sh/uv

2. プロジェクトを作成して設定する

# ディレクトリを作成
mkdir adb-mcp-server
cd adb-mcp-server

# ファイル（main.pyとpyproject.toml）を保存
# その後、以下を実行:

# 依存関係をインストール
uv sync

# 動作をテスト
uv run python main.py

3. ファイル構造

adb-mcp-server/
├── main.py              # サーバーの主要コード
├── pyproject.toml        # プロジェクトの設定
├── README.md            # このファイル
└── .venv/              # 仮想環境（uvによって作成）

⚙️ Claude Desktopでの設定

Claude Desktopの設定ファイルに以下の設定を追加します。

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "adb": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\caminho\\para\\adb-mcp-server",
        "run",
        "python",
        "main.py"
      ]
    }
  }
}

実際のパスを指定した例:

{
  "mcpServers": {
    "adb": {
      "command": "uv",
      "args": [
        "--directory", 
        "C:\\Users\\Cristiano\\Documents\\adb-mcp-server",
        "run",
        "python", 
        "main.py"
      ]
    }
  }
}

📱 Androidデバイスの準備

1. 開発者オプションを有効にする

   • 設定 > 端末情報 を開きます。
   • "バージョン番号"を7回タップします。

2. USBデバッグを有効にする

   • 設定 > 開発者オプション を開きます。
   • "USBデバッグ"を有効にします。

3. USBで接続する

   • デバイスをPCに接続します。
   • Androidで承認のプロンプトを受け入れます。

4. 接続をテストする

# ADBのディレクトリに移動
cd "C:\Users\Cristiano\Programação\ADB"
.\adb.exe devices

💻 使用例

基本コマンド

"接続されているAndroidデバイスを一覧表示して"
"私の携帯電話にインストールされているアプリは何ですか？"
"スクリーンショットを撮り、C:\Screenshots\tela.pngに保存して"
"私の携帯電話のバッテリー情報を表示して"

自動化と制御

"私の携帯電話の座標500, 800をタップして"
"私の携帯電話に'こんにちは、世界'と入力して"
"座標300,500から300,200までスワイプして"
"ホームボタンを押す（keyevent 3）"

開発とデバッグ

"私の携帯電話で'getprop ro.build.version.release'コマンドを実行して"
"フィルター'Error'でシステムの最後の50件のログを表示して"
"C:\Downloads\meuapp.apkのアプリをインストールして"
"com.exemplo.meuappアプリをアンインストールして"

ファイルの転送

"C:\Downloads\foto.jpgを/sdcard/Pictures/に送信して"
"/sdcard/Download/documento.pdfをC:\Documentos\にダウンロードして"

🔧 利用可能なコマンド

🔍 トラブルシューティング

エラー: "ADBが見つかりません"

# コード内のパスを確認
# main.pyのADB_PATH変数を編集
ADB_PATH = r"C:\Users\Cristiano\Programação\ADB\adb.exe"

エラー: "デバイスが見つかりません"

# 手動でテスト
cd "C:\Users\Cristiano\Programação\ADB"
.\adb.exe devices

# デバイスが表示されない場合:
# 1. USBケーブルを再接続します。
# 2. USB承認を取り消し、再度承認します。
# 3. メーカーのUSBドライバーをインストールします。

エラー: "Permission denied"

• 一部のコマンドにはroot権限が必要です。
• アプリが必要なパーミッションを持っていることを確認します。
• 一部のコマンドは開発者モードでのみ機能します。

サーバーのテスト

# プロジェクトのディレクトリで
uv run python main.py

# エラーなしのメッセージが表示されれば、サーバーは正常に動作しています。
# Ctrl+Cを押して停止します。

🚀 uvの便利なコマンド

# 依存関係をインストール/更新
uv sync

# サーバーを実行
uv run python main.py

# 新しい依存関係を追加
uv add nome-da-biblioteca

# すべての依存関係を更新
uv sync --upgrade

# 依存関係を確認
uv tree

🔐 セキュリティ

⚠️ 重要提示

このサーバーは、ユーザーの権限でADBコマンドを実行します。

💡 使用建议

• 自分のデバイスでのみ使用してください。
• 未知のシェルコマンドを実行する際には注意してください。
• ADBを最新の状態に保ちます。
• 複数のデバイスが接続されている場合、デバイスはIDで分離されます。

📈 将来の改善点

• [ ] 複数のデバイスを同時にサポート
• [ ] モニタリング用のWebインターフェース
• [ ] 頻繁に使用するコマンドのキャッシュ
• [ ] 詳細な操作ログ
• [ ] カスタムコマンドのサポート
• [ ] 視覚的な制御のためのscrcpyとの統合

🤝 貢献方法

1. プロジェクトをフォークします。
2. ブランチを作成します: git checkout -b minha-feature
3. コミットします: git commit -m '新機能'
4. プッシュします: git push origin minha-feature
5. プルリクエストを作成します。

📄 ライセンス

MITライセンス - 自由に使用してください！

📞 サポート

一般的な問題:

1. ✅ uvがインストールされていることを確認します: uv --version
2. ✅ コード内のADBのパスを確認します。
3. ✅ MCPを使用する前に、ADBを手動でテストします。
4. ✅ Claude Desktopのログを確認してエラーをチェックします。
5. ✅ デバイスがUSBデバッグを許可していることを確認します。

高度なデバッグ:

# ADBを手動でテスト
"C:\Users\Cristiano\Programação\ADB\adb.exe" devices

# 特定のコマンドをテスト
"C:\Users\Cristiano\Programação\ADB\adb.exe" shell "getprop ro.build.version.release"

# PythonがMCPを見つけるか確認
uv run python -c "import mcp; print('MCP OK')"