Skip to main content
Glama
devicebase

Devicebase MCP Server

Official
by devicebase

Devicebase MCP Server

MCP (Model Context Protocol) server for remote mobile device control via Devicebase API.

Features

  • Device Management: List devices, get device info

  • Touch Interactions: Tap, double-tap, long-press, swipe

  • Navigation: Back, Home buttons

  • App Management: Launch apps, get current app

  • Text Input: Input text, clear text

  • UI Inspection: Dump hierarchy, screenshot

Related MCP server: AutoBot MCP

Requirements

  • Python 3.11+

  • Devicebase API key

Installation

# Using uv (recommended)
uv sync

# Using pip
pip install -e .

Configuration

Set your Devicebase API key via environment variable:

export DEVICEBASE_API_KEY="your-api-key"
export DEVICEBASE_BASE_URL="https://api.devicebase.cn"  # Optional, default provided

Usage

Standalone Server

DEVICEBASE_API_KEY=your-key uv run python -m devicebase_mcp

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "devicebase": {
      "command": "uv",
      "args": ["run", "python", "-m", "devicebase_mcp"],
      "env": {
        "DEVICEBASE_API_KEY": "${DEVICEBASE_API_KEY}"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "devicebase": {
      "command": "uv",
      "args": ["run", "python", "-m", "devicebase_mcp"],
      "env": {
        "DEVICEBASE_API_KEY": "${DEVICEBASE_API_KEY}"
      }
    }
  }
}

Available Tools

Tool

Description

list_devices

List available devices

get_device_info

Get device details

tap

Single tap at coordinates

double_tap

Double tap

long_press

Long press

swipe

Swipe gesture

press_back

Press back button

press_home

Press home button

launch_app

Launch an app

get_current_app

Get foreground app

input_text

Input text

clear_text

Clear text field

dump_hierarchy

Get UI tree

screenshot

Get screen capture

Development

# Install with dev dependencies
uv sync --extra dev

# Run tests
pytest

# Lint
ruff check .

# Format
ruff format .

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    A
    maintenance
    Enables AI assistants to automate mobile app testing and development for iOS and Android through natural language interactions. Supports intelligent element identification, session management, automated test generation, and comprehensive device interactions including clicks, swipes, screenshots, and app management.
    31
    5,170 npm
    477
    Apache 2.0
  • F
    license
    B
    quality
    D
    maintenance
    Enables remote control and automation of Android devices through the Model Context Protocol, supporting UI interactions, app management, ADB commands, screenshots, and device information retrieval via AutoBot API.
    53
    -
  • A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to control mobile and desktop devices with natural language, including running automation tasks, taking screenshots, and managing devices.
    6
    5 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables remote control of Android devices via ADB, including screen operations, input, app management, file transfer, and advanced tools like UI testing and performance analysis.
    24
    MIT