Which integrations are available for this server?

Allows for automating and testing Android devices through the Gbox SDK, providing capabilities to spin up virtual or physical environments, manage applications, capture screenshots, and perform AI-powered UI actions via natural language instructions.

How do I use Android Tester MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Android Tester MCP Install the app and use AI to click the 'Sign Up' button." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Install Dependencies
npm install
Set Environment Variables
Create a .env file in the project root:
GBOX_API_KEY=your_gbox_api_key_here
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.