PhoneMcp - Android Phone Control via ADB

Name: PhoneMcp - Android Phone Control via ADB
Author: kengerlwl

@kengerlwl

PhoneMcp - Android Phone Control via ADB について

Control your Android phone via ADB using AI assistants. Supports both zero-config Skill mode (CatPaw/Claude Code) and standard MCP server mode (Claude Desktop/Cursor). Features: screen capture, tap/swipe gestures, text input, app management, file transfer, shell commands, and mor

#android #adb #mobile #phone #automation

基本情報

カテゴリ

開発者ツール

トランスポート

stdio

公開者

kengerlwl

投稿者

kenger

設定

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

{
  "mcpServers": {
    "phoneMcp": {
      "command": "python",
      "args": [
        "main.py",
        "serve"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is PhoneMcp - Android Phone Control via ADB?

PhoneMcp is an AI phone control tool that allows AI assistants to directly see an Android phone’s screen, tap buttons, input text, and open apps via ADB. It provides two integration modes — Skill (zero-config) and MCP — and is designed for users who want to automate phone operations through natural language.

How to use PhoneMcp - Android Phone Control via ADB?

Enable USB debugging on the Android phone and connect it via USB or WiFi. For Skill mode, download the Skill archive from Releases and unzip it into the AI client’s Skill directory (e.g., ~/.catpaw/skills/phone-mcp/). For MCP mode, download the standalone executable and start the server with ./phone-mcp serve, then configure the MCP client with the SSE or STDIO transport. The tool automatically detects connected devices.

Key features of PhoneMcp - Android Phone Control via ADB

Screenshot capture of the phone screen
Touch operations: tap, double‑tap, swipe
Text input with full Chinese support
System key press (back, home, volume, power)
App launch, search, and current app retrieval
UI element recognition for precise tapping by index/text
OCR mode for WebView, games, and Flutter apps
Multi‑device support via USB and WiFi

Use cases of PhoneMcp - Android Phone Control via ADB

Open an app and send a message via natural language command
Take a screenshot to see the current phone interface
Open settings and toggle WiFi off
Search for a product on Taobao and tap the result
List all installed apps on the phone

FAQ from PhoneMcp - Android Phone Control via ADB

What’s the difference between Skill mode and MCP mode?

Skill mode requires no configuration — just unzip and place the folder in the AI client’s Skill directory. MCP mode requires starting a server and adding a configuration block in the MCP client (e.g., Claude Desktop, Cursor).

What are the system requirements?

Python 3.10+ and an Android device with USB debugging enabled. The standalone executables embed ADB, so no separate ADB installation is needed.

How do I connect the phone?

Connect via USB (preferred) or WiFi. The server automatically detects devices. First enable USB debugging on the phone and accept the authorization prompt.

Does it support multiple devices?

Yes, it can list, connect, and manage multiple Android devices simultaneously.

Which transports are available for MCP mode?

SSE (default, listens on http://0.0.0.0:8009/Phone/sse) and STDIO (for clients that invoke the executable directly).

「開発者ツール」の他のコンテンツ

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K