Devicebase 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

Development

# Install with dev dependencies
uv sync --extra dev

# Run tests
pytest

# Lint
ruff check .

# Format
ruff format .

License

MIT