gbox

GBOX MCP Server allows AI agents to operate and automate interactions across Android devices, Linux desktops, and browser sessions via dedicated modes. You can run Android automation, Linux desktop control (with optional browser support), or browser automation with advanced tab management. Each mode authenticates with your GBOX API key and communicates with the GBOX backend to perform tasks such as UI automation, web navigation, and device control. To use a mode, provision your API key and environment, then launch the corresponding MCP server entry (gbox-android, gbox-linux, or gbox-browser) with the provided npx command structure. Once running, you can issue commands and scripts to drive the target environment through the MCP server’s tooling.

Prerequisites:

• Node.js (14.x+ or 16.x+ recommended) and npm installed on your machine
• Optional: GBOX CLI setup and an API key obtained from gbox.ai/dashboard

Step-by-step installation:

1. Install Node.js and npm from https://nodejs.org/
2. Install the MCP server package globally (uses npx for per-run execution): npm install -g @gbox.ai/mcp-server
3. Ensure you are logged in to GBOX CLI (if you use gbox CLI): gbox login
4. Create a configuration file (e.g., mcp_config.json) with the server entries shown in the mcp_config section above, replacing API keys/URLs as needed.
5. Run your desired mode via npx (examples below) or integrate into your deployment script:

Android mode:

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

Linux mode:

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

Browser mode:

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

Note: You can omit the env block if you have already run gbox login and saved your profile settings.

Tips and considerations:

• You can omit the env section if you have successfully run gbox login in the CLI; environment is loaded from your CLI profile.
• Ensure GBOX_API_KEY is kept secure and not exposed in shared repos.
• The Browser mode provides tab management commands (list_tabs, open_tab, switch_tab, close_tab) and standard interaction tools (click, scroll, press_key, type, screenshot).
• If you encounter connectivity issues, verify GBOX_BASE_URL is reachable and that your API key has permissions for the MCP server features.
• When running on local devices, ensure those devices are registered or accessible via the GBOX platform as described in the documentation.