Devicebase Server

БесплатноНе проверен

Enables remote control of mobile devices via the Devicebase API, including touch gestures, app management, and UI inspection.

автор: devicebase

GitHub Embed

Описание

Enables remote control of mobile devices via the Devicebase API, including touch gestures, app management, and UI inspection.

README

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

from github.com/devicebase/devicebase-mcp

Установить Devicebase Server в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install devicebase-mcp-server

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add devicebase-mcp-server -- uvx --from git+https://github.com/devicebase/devicebase-mcp devicebase-mcp

FAQ