内容
# GBOX MCP SERVER
[](https://www.npmjs.com/package/@gbox.ai/mcp-server)
[](LICENSE)
## 描述
GBOX MCP Server 使 AI Agents（Cursor/Claude Code/...）能够操作 Android 设备、Linux 环境和浏览器会话。这些设备可以是由 gbox.ai 提供的云虚拟机/云物理机或您的本地设备。它可用于 Android 应用测试、网页自动化和通用计算任务。
## 支持的平台
- **Android** - 控制 Android 设备（云端或本地）
- **Linux** - 控制 Linux 桌面环境
- **浏览器** - 控制带有标签管理的浏览器会话
## 使用方法
### Android 模式
用于 Android 设备自动化。有关详细信息，请参见 [GBOX Android MCP](https://docs.gbox.ai/docs-mcp/android-mcp-server)。
```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 模式
用于带有浏览器支持的 Linux 桌面自动化。
```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"
}
}
```
### 浏览器模式
用于网页自动化，支持预先打开的浏览器和高级标签管理。
```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"
}
}
```
**浏览器模式功能：**
- 浏览器最大化打开且无控制条
- 标签管理：`list_tabs`、`open_tab`、`switch_tab`、`close_tab`
- 标准交互工具：`click`、`scroll`、`press_key`、`type`、`screenshot`
## 配置
**注意：** 如果您已在 CLI 中成功运行 `gbox login`，则可以省略 `env` 部分。
有关登录和配置个人资料的说明，请参阅 [Gbox CLI 文档](https://github.com/babelcloud/gbox)。
如果您已经登录，请从 [gbox.ai/dashboard](https://gbox.ai/dashboard) 的个人选项卡中获取您的 `GBOX_API_KEY`。
要使用您的本地 Android 设备，请查看 [注册您的设备](https://docs.gbox.ai/cli/register-local-device)。
## 资源
- [官方文档](https://docs.gbox.ai)
- [GBOX Android MCP](https://docs.gbox.ai/docs-mcp/android-mcp-server)
- [GBOX CLI](https://github.com/babelcloud/gbox)
- [仪表板](https://gbox.ai/dashboard)
MCP 市场
