Mcp Android Adb Server

Name: Mcp Android Adb Server
Author: github-hewei

@github-hewei

リポジトリ

Mcp Android Adb Server について

通过AI大模型操作安卓设备

基本情報

カテゴリ

その他

ライセンス

GPL-3.0

ランタイム

トランスポート

stdio

公開者

github-hewei

投稿者

wei he

設定

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

{
  "mcpServers": {
    "mcp-android-adb-server": {
      "name": "mcp-android-adb-server",
      "command": "D:\\www\\golang\\mcp-android-adb-server\\mcp-android-adb-server.exe",
      "env": {
        "DEVICE_ID": "E6EDU20723063683",
        "SCREEN_LOCK_PASSWORD": "123456"
      }
    }
  }
}

ツール

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

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

概要

What is Mcp Android Adb Server?

Mcp Android Adb Server is an MCP (Model Context Protocol) service for operating Android devices via ADB (Android Debug Bridge). It is designed for developers who need programmatic control over Android devices, including app management, screen control, input simulation, and device information retrieval.

How to use Mcp Android Adb Server?

Clone the repository, build with go build, then configure the server in your MCP client using a JSON object with the command path and required environment variables, including DEVICE_ID. Optional variables enable screen unlocking and visual model support for screenshot descriptions.

Key features of Mcp Android Adb Server

App installation, uninstallation, and management via ADB
Screen locking, unlocking, and status checks
Text input, key press, tap, and gesture simulation
Swipe gestures in four directions
Device information including screen size, DPI, and system info
Screenshot description using optional visual models (e.g., qwen2.5-vl)
Execute arbitrary shell commands on the device

Use cases of Mcp Android Adb Server

Automate app installation and testing on Android devices
Remotely control device screen for unattended operations
Simulate user input for UI testing or accessibility scripts
Retrieve device hardware and software information programmatically

FAQ from Mcp Android Adb Server

What is required to use Mcp Android Adb Server?

You need an Android device with USB debugging enabled, ADB installed on your host, and the device ID (DEVICE_ID) obtained via adb devices. A screen lock password (SCREEN_LOCK_PASSWORD) is optional.

How do I enable the visual model for screenshot descriptions?

Set VISUAL_MODEL_ON to true and provide VISUAL_MODEL_API_KEY, VISUAL_MODEL_BASE_URL, and VISUAL_MODEL_NAME (e.g., qwen/qwen2.5-vl-72b-instruct:free).

What environment variables are supported?

DEVICE_ID (required), SCREEN_LOCK_PASSWORD, VISUAL_MODEL_ON, VISUAL_MODEL_API_KEY, VISUAL_MODEL_BASE_URL, and VISUAL_MODEL_NAME (all optional except DEVICE_ID).