基本能力
产品定位
gbox是一个为MCP集成和AI代理设计的沙箱环境,旨在安全地执行本地命令和任务。
核心功能
- 沙箱环境:提供安全的执行环境,支持本地和k8s集群运行。
- MCP集成:与Claude Desktop/Cursor等MCP客户端无缝集成。
- 多任务支持:支持生成图表、PDF、数据分析、文件处理和任意任务执行。
适用场景
- 生成图表:如特斯拉股票价格图表。
- 生成PDF:如最新AI新闻的PDF。
- 数据分析:如比较Nvidia/Tesla市值。
- 文件处理:如压缩共享文件夹中的照片。
- 任务执行:如下载YouTube视频。
工具列表
- gbox命令行工具:用于管理沙箱容器和MCP配置。
gbox cluster setup
:设置集群环境。gbox box create
:创建容器。gbox mcp export
:导出MCP配置。
常见问题解答
- 如何运行开发环境的gbox:停止已安装的gbox,运行
make api-dev
,然后使用开发环境的命令。 - 如何连接MCP客户端到开发环境的MCP服务器:运行
make mcp-dev
,然后导出并合并MCP配置。 - 如何更新MCP内容:运行
make build
更新dist/index.js
,然后导出并合并MCP配置。
使用教程
使用依赖
- macOS 10.15或更高版本
- Docker Desktop for Mac
- Homebrew
安装教程
```bash
通过Homebrew安装
brew tap babelcloud/gru && brew install gbox
初始化环境
gbox setup
导出MCP配置并合并到Claude Desktop
gbox mcp export --merge-to claude
重启Claude Desktop
```
更新步骤
```bash
更新gbox到最新版本
brew update && brew upgrade gbox
更新环境
gbox setup
导出并合并最新MCP配置到Claude Desktop
gbox mcp export --merge-to claude
重启Claude Desktop
```
调试方式
```bash
集群管理
gbox cluster setup # 设置集群环境
gbox cluster cleanup # 清理集群环境
容器管理
gbox box list # 列出容器
gbox box inspect
```