MCP.so
ログイン
A

Android MCP

@tomdwipo

Android MCP について

A lightweight MCP server for Android operating system automation. This server provides tools to interact directly with Android devices, enabling automated testing, app interaction, and device control.

基本情報

カテゴリ

AI とエージェント

トランスポート

stdio

公開者

tomdwipo

投稿者

Tom

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "android-mcp": {
      "type": "stdio",
      "command": "bash",
      "args": [
        "-c",
        "cd /path/to/agent/mcp/android && source .venv/bin/activate && uv run main.py --emulator"
      ],
      "alwaysAllow": [
        "State-Tool",
        "Click-Tool",
        "Type-Tool",
        "Swipe-Tool"
      ]
    }
  }
}

ツール

9

Click on specific coordinates

Get device state with optional screenshot

Long press on coordinates

Swipe between coordinates

Type text at coordinates

Drag and drop between coordinates

Press hardware buttons

Access notification panel

Wait for specified duration

概要

What is Android MCP?

Android MCP is a lightweight MCP server for Android operating system automation. It provides tools to interact directly with Android devices, enabling automated testing, app interaction, and device control.

How to use Android MCP?

Install Python 3.13+, uv package manager, and set up the project with uv sync. Connect an Android device with USB debugging enabled, or use an emulator with the --emulator flag. Run the server via uv run main.py or configure it in MCP client settings such as Claude Desktop.

Key features of Android MCP

  • Click, long click, swipe, drag, and type on Android devices.
  • Get device state with optional visual screenshots.
  • Press hardware buttons and access notifications.
  • Wait functionality for timing control.
  • Works with both physical devices and Android emulators.

Use cases of Android MCP

  • Automated app testing and UI interaction.
  • Remote device control and scripting.
  • Repetitive task automation on Android devices.
  • Integration with AI assistants for device manipulation.

FAQ from Android MCP

What dependencies are required?

Python 3.13 or higher, uv package manager, ADB (Android Debug Bridge), and an Android device or emulator with USB debugging enabled.

How do I connect a physical device?

Enable Developer Options and USB debugging on the Android device, then connect via USB and verify with adb devices. Run uv run main.py (without the --emulator flag).

How do I use the server with an emulator?

Start the emulator, verify connection with adb connect emulator-5554, then run uv run main.py --emulator.

What tools are available?

Click, State, Long-Click, Swipe, Type, Drag, Press, Notification, and Wait tools. See the README for exact parameters.

How do I resolve “device not found” issues?

Ensure USB debugging is enabled, check adb devices output, try different cables/ports, or restart ADB with adb kill-server && adb start-server.

コメント

「AI とエージェント」の他のコンテンツ