Android MCP

🚀 🤖 Android MCP

Android-MCP は、AIエージェントとAndroidデバイスをつなぐ軽量なオープンソースのブリッジです。MCPサーバーとして動作し、大規模言語モデルのエージェントが、従来のコンピュータビジョンパイプラインや事前にプログラムされたスクリプトに依存することなく、アプリのナビゲーション、UIの操作、自動化されたQAテストなどの実世界のタスクを実行できます。

https://github.com/user-attachments/assets/cf9a5e4e-b69f-46d4-8487-0f61a7a86d67

🚀 クイックスタート

このセクションでは、Android-MCPの基本的な使い方を説明します。

✨ 主な機能

• Androidネイティブ統合
  ADBとAndroidアクセシビリティAPIを介してUI要素とやり取りできます。アプリの起動、タップ、スワイプ、テキスト入力、ビュー階層の読み取りなどが可能です。

• 独自のLLM/VLMを使用可能
  任意の言語モデルと連携でき、微調整されたCVモデルやOCRパイプラインは必要ありません。

• モバイル自動化のための豊富なツールセット
  ジェスチャー、キーストローク、キャプチャ、デバイス状態、シェルコマンドの実行などの事前構築されたツールが用意されています。

• リアルタイムインタラクション
  アクション間（例えば、2回のタップ）の典型的なレイテンシは、デバイスのスペックと負荷に応じて 2 - 4秒 程度です。

サポートされるオペレーティングシステム

• Android 10+

📦 インストール

前提条件

• Python 3.10+
• UIautomator2
• Androidエミュレーター / Androidデバイス

始めるには

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

git clone https://github.com/CursorTouch/Android-MCP.git
cd Android-MCP

2. 依存関係をインストールする

uv python install 3.10
uv sync

3. MCPサーバーに接続する

4. Claude Desktopの設定ファイルを見つけます。

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. 以下のJSONをClaude Desktopの設定に追加します。

  {
    "mcpServers": {
      "android-mcp": {
        "command": "path/to/uv",
        "args": [
          "--directory",
          "path/to/Android-MCP",
          "run",
          "main.py",
          "--emulator"
        ]
      }
    }
  }

以下を置き換えます。

• path/to/uv を実際のuv実行可能ファイルのパスに置き換える
• path/to/Android-MCP をこのリポジトリをクローンした絶対パスに置き換える

注意: --emulator はエミュレーターで実行するためのオプションです。実際のデバイスを使用する場合は、このオプションを削除してください。

3. Claude Desktopを再起動する

Claude Desktopを開くと、「android-mcp」が統合として表示されるはずです。

トラブルシューティングのヒント（ログの場所、一般的なADBの問題など）については、MCPドキュメント を参照してください。

🔧 MCPツール

Claudeは、Windowsとやり取りするために以下のツールにアクセスできます。

• State-Tool: デバイスの状態を把握するためのツール。
• Click-Tool: 指定された座標で画面をクリックするツール。
• Long-Click-Tool: 指定された座標で画面を長押しするツール。
• Type-Tool: 指定された座標でテキストを入力するツール（既存のテキストをオプションでクリアできます）。
• Swipe-Tool: ある場所から別の場所にスワイプするツール。
• Drag-Tool: ある点から別の点にドラッグするツール。
• Press-Tool: モバイルデバイスのキー（戻る、音量アップなど）を押すツール。
• Wait-Tool: 定義された期間一時停止するツール。
• State-Tool: アクティブなアプリと対話可能なUI要素の結合されたスナップショットを取得するツール。
• Notification-Tool: デバイスで見られる通知にアクセスするツール。
• Shell-Tool: Androidデバイスでシェルコマンドを実行するツール。

⚠️ 重要提示

⚠️ 重要提示

Android-MCPは、モバイルデバイス上で任意のUIアクションを実行できます。信頼できないプロンプトやエージェントを実行する場合は、制御された環境（エミュレーター、テストデバイス）で使用してください。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細は LICENSE を参照してください。

🤝 コントリビュート

コントリビューションは歓迎されます！開発環境のセットアップとPRのガイドラインについては、CONTRIBUTING を読んでください。

❤️ によって作成されました Jeomon George

引用

@misc{
  author       = {Jeomon George},
  title        = {Android-MCP},
  year         = {2025},
  publisher    = {GitHub},
  howpublished = {\url{https://github.com/CursorTouch/Android-MCP}},
  note         = {Lightweight open-source bridge between LLM agents and Android},
}