Android Tester MCP

Automate Android devices using the Gbox SDK.

View on GitHub →

Android Tester MCP

A Model Context Protocol (MCP) plugin for automating Android devices using the Gbox SDK. This plugin provides tools for creating Android boxes, taking screenshots, performing AI-powered UI actions, and managing applications.

Features

  • Create Android Boxes: Spin up virtual or physical Android devices
  • Screenshot Capture: Take screenshots of the current display
  • AI-Powered Actions: Perform UI actions using natural language instructions
  • App Management: Install, uninstall, and launch Android applications
  • Box Management: List and get information about your Android boxes

Setup

  1. Install Dependencies

    npm install

  2. Set Environment Variables

    Create a .env file in the project root:

    GBOX_API_KEY=your_gbox_api_key_here

  3. Build the Project

    npm run build

Usage

This is an MCP server that provides tools for Android automation. Once running, you can use the following tools:

Config in Cursor

{
  "mcpServers": {
    "gbox-android": {
      "command": "node",
      "args": ["/YOU_PATH_TO_THIS_REPO/android-tester-mcp/dist/index.js"],
      "env": {
        "GBOX_API_KEY": "YOUR API KEY"
      }
    }
  }
}

Available Tools

  • create_android_box: Create a new Android box with specified configuration
  • list_boxes: List all current boxes belonging to your API key
  • get_box: Get detailed information about a specific box
  • get_screenshot: Take a screenshot of the Android device
  • ai_action: Perform UI actions using natural language (e.g., "click the login button")
  • install_apk: Install an APK file from local path or URL
  • uninstall_apk: Uninstall an app by package name
  • open_app: Launch an installed application

Requirements

  • Node.js and npm
  • Valid Gbox API key
  • TypeScript (for development)

Sample Prompts in Cursor

Test the apk of this project like a user, just create an android environment on gbox, and install it and test it by instructing the MCP tool ai_action. Keep developing and testing until all requirements are met.

Related Servers