Content
# GBOX MCP SERVER
[](https://www.npmjs.com/package/@gbox.ai/mcp-server)
[](LICENSE)
## Description
GBOX MCP Server enables AI Agents (Cursor/Claude Code/...) to operate Android devices, Linux environments, and browser sessions. The devices can be Cloud VM/Cloud Physical provided by gbox.ai or your local devices. It can be used for Android App Testing, web automation, and general-purpose computing tasks.
## Supported Platforms
- **Android** - Control Android devices (cloud or local)
- **Linux** - Control Linux desktop environments
- **Browser** - Control browser sessions with tab management
## Usage
### Android Mode
For Android device automation. See [GBOX Android MCP](https://docs.gbox.ai/docs-mcp/android-mcp-server) for details.
```json
"gbox-android": {
"command": "npx",
"args": [
"-y",
"@gbox.ai/mcp-server@latest",
"--android"
],
"env": {
"GBOX_API_KEY": "gbox_xxxx",
"GBOX_BASE_URL": "https://gbox.ai/api/v1"
}
}
```
### Linux Mode
For Linux desktop automation with browser support.
```json
"gbox-linux": {
"command": "npx",
"args": [
"-y",
"@gbox.ai/mcp-server@latest",
"--linux"
],
"env": {
"GBOX_API_KEY": "gbox_xxxx",
"GBOX_BASE_URL": "https://gbox.ai/api/v1"
}
}
```
### Browser Mode
For web automation with pre-opened browser and advanced tab management.
```json
"gbox-browser": {
"command": "npx",
"args": [
"-y",
"@gbox.ai/mcp-server@latest",
"--browser"
],
"env": {
"GBOX_API_KEY": "gbox_xxxx",
"GBOX_BASE_URL": "https://gbox.ai/api/v1"
}
}
```
**Browser Mode Features:**
- Browser opens maximized without controls
- Tab management: `list_tabs`, `open_tab`, `switch_tab`, `close_tab`
- Standard interaction tools: `click`, `scroll`, `press_key`, `type`, `screenshot`
## Configuration
**Note:** You can omit the `env` section if you have successfully run `gbox login` in CLI.
For instructions on logging in and configuring your profile, refer to the [Gbox CLI Documentation](https://github.com/babelcloud/gbox).
If you are already logged in, obtain your `GBOX_API_KEY` from the Personal tab at [gbox.ai/dashboard](https://gbox.ai/dashboard).
To use your local Android devices, check [Register Your Own Device](https://docs.gbox.ai/cli/register-local-device).
## Resources
- [Official Documentation](https://docs.gbox.ai)
- [GBOX Android MCP](https://docs.gbox.ai/docs-mcp/android-mcp-server)
- [GBOX CLI](https://github.com/babelcloud/gbox)
- [Dashboard](https://gbox.ai/dashboard)
Connection Info
You Might Also Like
markitdown
MarkItDown-MCP is a lightweight server for converting URIs to Markdown.
firecrawl
Firecrawl MCP Server enables web scraping, crawling, and content extraction.
servers
Model Context Protocol Servers
Time
A Model Context Protocol server for time and timezone conversions.
Filesystem
Node.js MCP Server for filesystem operations with dynamic access control.
Sequential Thinking
A structured MCP server for dynamic problem-solving and reflective thinking.