MCP.so
登录
A

Android MCP Server

@tomdwipo

基本信息

分类

AI 与智能体

传输方式

stdio

作者

tomdwipo

提交者

Tom

关于 Android MCP Server

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.

Android MCP Server 配置

使用下面的配置,将此服务器添加到你的 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"
      ]
    }
  }
}

Android MCP Server 工具

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.

常见问题

1

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.

2

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).

3

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`.

4

What tools are available?

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

5

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 与智能体 分类下的更多 MCP 服务器