gbox

GBOX provides an MCP server that lets Claude Code, Cursor, or other agents control Android environments via GBOX. This MCP server is exposed through the GBOX CLI integration and exports an MCP configuration that points your agent environment at the GBOX MCP server package. The typical workflow is to export the MCP config for your agent and merge it into the target agent (for example Claude Code or Cursor). Once configured, the agent can orchestrate Android device actions, run apps, automate tasks, and interact with local or cloud Android environments supported by GBOX. The server is designed to enable Android automation workflows, including app testing, UI automation, and device-level control, via MCP commands emitted by the agent.

To use it, generate the MCP config snippet (as shown in the README) and merge it into your agent’s MCP configuration. You can export the config for the target agent using the GBOX CLI, for example exporting to Cursor or Claude Code. The MCP server listens through the npx invocation and pulls the latest @gbox.ai/mcp-server package, enabling your agent to communicate with GBOX Android environments.

Prerequisites:

• Node.js and npm installed on your machine (Node.js 14+ recommended).
• Access to the internet to fetch the MCP server package from npm registry.

Installation steps:

1. Ensure Node.js and npm are installed. Verify with: node -v npm -v

2. Use the MCP server configuration snippet provided in the README to create your mcp configuration file. For example, create a file named mcp.json with:

{
  "mcpServers": {
    "gbox-android": {
      "command": "npx",
      "args": [
        "-y",
        "@gbox.ai/mcp-server@latest"
      ]
    }
  }
}

3. Run the MCP server using the recommended npx command. In a terminal, execute:

npx -y @gbox.ai/mcp-server@latest

This will start the MCP server with the gbox-android configuration. If you prefer to pin a specific version, replace @latest with a version tag, e.g., @1.2.3.

4. If you need to export the MCP config for your agent (Claude Code or Cursor) and merge it, follow the commands shown in the README or your agent’s integration guide. For example:

gbox mcp export --merge-to cursor
gbox mcp export --merge-to claude-code --scope project

Prerequisites note: The GBOX CLI and dependencies (ADB, Appium, etc.) will be installed automatically on demand if you choose to install dependencies as part of the setup.

Notes:

• Currently, GBOX MCP can only control Android environments. If you need integration with local devices, you may need to register your local Android device as described in the GBOX docs.
• The MCP server uses the npm package @gbox.ai/mcp-server; using npx fetches the latest package when you run the command. Pin versions if you require reproducible builds.
• Ensure Android debugging (ADB) and any required drivers are available in the environment where you run the MCP server. GBOX can auto-install dependencies when needed if you use the quick setup options.
• The exported MCP config can be merged into Claude Code or Cursor to enable seamless control of Android environments via MCP commands.