프로그래밍 제어를 제공하는 MCP(모델 컨텍스트 프로토콜) 서버입니다. 안드로이드 기기는 ADB(안드로이드 디버그 브리지)를 통해 제공됩니다. 이 서버는 노출됩니다 MCP가 접근할 수 있는 다양한 안드로이드 기기 관리 기능들 Claude 데스크톱 같은 클라이언트 그리고 코드 편집기 (예: 커서)

특징

• 🔧 ADB 명령 실행
• 📸 장치 스크린샷 캡처
• 🎯 UI 레이아웃 분석
• 📱 장치 패키지 관리

선수 조건

• 파이썬 3.x
• ADB(안드로이드 디버그 브리지) 설치 및 구성
• 안드로이드 기기 또는 에뮬레이터 (테스트 미완료)

설치

1. 저장소 복제:

2. 의존성 설치: 이 프로젝트는 UV를 사용합니다. 다양한 방법을 통한 관리 설치.

구성

서버는 다양한 사용 시나리오에서 유연한 장치 구성을 지원합니다.

장치 선택 모드

1. 자동 선택 (단일 기기에 권장)

• 설정 파일이 필요 없음
• 연결된 유일한 장치에 자동으로 연결됨
• 단일 테스트 장치로 개발하기에 완벽함

**2. 수동 장치 선택

• 여러 기기가 연결되어 있을 때 사용
• 구성 파일에서 정확한 장치를 지정하기

구성 파일 (선택 사항)

Android MCP Server

An MCP (Model Context Protocol) server that provides programmatic control over Android devices through ADB (Android Debug Bridge). This server exposes various Android device management capabilities that can be accessed by MCP clients like Claude desktop and Code editors (e.g. Cursor)

Features

• 🔧 ADB Command Execution
• 📸 Device Screenshot Capture
• 🎯 UI Layout Analysis
• 📱 Device Package Management

Prerequisites

• Python 3.x
• ADB (Android Debug Bridge) installed and configured
• Android device or emulator (not tested)

Installation

1. Clone the repository:

git clone https://github.com/minhalvp/android-mcp-server.git
cd android-mcp-server

2. Install dependencies: This project uses uv for project management via various methods of installation.

uv python install 3.11
uv sync

Configuration

The server supports flexible device configuration with multiple usage scenarios.

Device Selection Modes

1. Automatic Selection (Recommended for single device)

• No configuration file needed
• Automatically connects to the only connected device
• Perfect for development with a single test device

2. Manual Device Selection

• Use when you have multiple devices connected
• Specify exact device in configuration file

Configuration File (Optional)

The configuration file (config.yaml) is optional. If not present, the server will automatically select the device if only one is connected.

For Automatic Selection

Simply ensure only one device is connected and run the server - no configuration needed!

For Manual Selection

1. Create a configuration file:

cp config.yaml.example config.yaml

2. Edit config.yaml and specify your device:

device:
  name: "your-device-serial-here" # Device identifier from 'adb devices'

For auto-selection, you can use any of these methods:

device:
  name: null              # Explicit null (recommended)
  # name: ""              # Empty string  
  # name:                 # Or leave empty/comment out

Finding Your Device Serial

To find your device identifier, run:

adb devices

Example output:

List of devices attached
13b22d7f        device
emulator-5554   device

Use the first column value (e.g., 13b22d7f or emulator-5554) as the device name.

Usage Scenarios