Skip to main content
Glama
devicebase

Devicebase MCP Server

Official
by devicebase
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

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

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

This server cannot be installed

A
license - permissive license
-
quality - not tested
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/devicebase/devicebase-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server