A
securityA
licenseA
qualityFacilitates running Python code in a sandbox and generating images using the FLUX model via an MCP server compatible with clients like Goose and the Claude Desktop App.
Last updated -
2
21
Python
MIT License
GBOX
GBOX provides environments for AI Agents to operate computer and mobile devices.
Mobile Scenario: Your agents can use GBOX to develop/test android apps, or run apps on the Android to complete various tasks(mobile automation).
Desktop Scenario: Your agents can use GBOX to operate desktop apps such as browser, terminal, VSCode, etc(desktop automation).
MCP: You can also plug GBOX MCP to any Agent you like, such as Cursor, Claude Code. These agents will instantly get the ability to operate computer and mobile devices.
Installation
System Requirements
- MacOS
- Version: 10.15 or later
- Homebrew
Note: Using gbox on other platforms, please check npm package @gbox.ai/cli for installation instructions. You can also login to GBOX.AI to use web-based dashboard.
Installation Steps
Command Line Usage
Check GBOX CLI Reference for detailed usage.
SDK Usage
Check GBOX SDK Reference for detailed usage.
Use GBOX as a MCP Server(Login required)
Using GBOX CLI to configure MCP server to your Claude Code/Cursor:
Or copy paste the following content into your Claude Code/Cursor MCP config:
Note:
- Currently, GBOX MCP can only control Android environments.
- If you need Cursor/Claude Code to control your local Android device, please check Register Local Device
Android MCP Use Cases
| Use Case | Demo |
|---|---|
| Claude Code Develop/Test Android App | |
| Claude Code Compare Prices on eCommerce Apps |
Environments
Currently, GBOX supports the following environments:
- Android
- Linux Desktop/Browser
Android Environment
There are three types of Android environments, you can choose based on your needs:
1. Cloud Virtual Device:
Login to GBOX.AI to get a cloud virtual device. Best for testing and development.
2. Cloud Physical Device:
Login to GBOX.AI to get a cloud physical device. Cloud physical device is a real Android phone that you can use for production scenarios.
3. Local Physical Device:
Use your own physical device Register Local Device. Your local device can be any Android device that have Developer Mode enabled. Best for production scenarios and personal use.
Linux Desktop/Browser Environment
Login to GBOX.AI to get a Linux desktop/browser environment. Best for testing and development.
Develop gbox
Prerequisites
- Go 1.21 or later
- Make
- pnpm (via corepack)
- Node.js 16.13 or later
Build
Running Services
Contributing
We welcome contributions! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
- Fork the repository
- Create your feature branch (
git checkout -b username/feature-name) - Commit your changes (
git commit -m 'Add some feature') - Push to the branch (
git push origin username/feature-name) - Open a Pull Request
Things to Know about Dev and Debug Locally
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Gru-sandbox (gbox) は、MCP 統合やその他の AI エージェントの使用例向けに自己ホスト可能なサンドボックスを提供するオープン ソース プロジェクトです。
Related MCP Servers
- AsecurityFlicenseAqualityA bridge server that connects MCP clients (like Claude Desktop) to Google Apps Script, allowing execution of GAS scripts through natural language interfaces.Last updated -11JavaScript
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with Google Cloud Platform environments through natural language, allowing users to query and manage GCP resources during conversations.Last updated -9187140TypeScriptMIT License
- -securityFlicense-qualityA local server that enables Google's Gemini AI to safely read, write, and list files within a controlled sandbox folder on your computer through natural language chat interactions.Last updated -4Python