gbox

gbox

gbox es un entorno de pruebas autoalojado para que los agentes de IA ejecuten comandos, naveguen por internet y usen dispositivos de escritorio y móviles. Consulte la sección "Funciones" para obtener más información.

Este proyecto se basa en la tecnología de gru.ai. Se ha probado en más de 100 000 trabajos de agente.

Como MCP se está volviendo cada vez más popular, también implementamos un servidor MCP para facilitar la integración directa en el cliente MCP, como Claude Desktop/Cursor.

Características

1. Terminal
   • Ejecutar cualquier comando de Linux
   • Ejecutar scripts de Python directamente
   • Compartir sesión entre invocaciones [en desarrollo]
2. Archivo
   • Montar las carpetas de la máquina host en el entorno sandbox
   • Acceda a los archivos de sandbox a través de enlaces http
   • Leer el contenido del archivo en modo multimodal
   • Escribir/reescribir archivos
   • Editar archivos [en desarrollo]
   • Buscar archivos [en desarrollo]
3. Navegador
   • Abre cualquier URL y devuelve el contenido en modo multimodal
   • Descargar desde cualquier URL [en desarrollo]
   • Operar el navegador según las instrucciones
   • La toma de posesión humana [subdesarrollo]
4. Servidor HTTP
   • Iniciar el servicio http en cualquier carpeta a pedido [en desarrollo]
5. SDK
   • SDK de Python: Instalación mediante pip install pygbox . Consulta PyPI para más detalles.
   • SDK de Typescript
6. MCP
   • Compatibilidad estándar con MCP
   • Integrar Claude Desktop y Cursor

Utilice gbox como SDK

SDK de Python

Documentación del SDK de Python

SDK de Typescript

Documentación del SDK de Typescript

Utilice gbox como CLI

Instalación

Requisitos del sistema

• macOS 10.15 o posterior
• Docker Desktop para Mac
• Cerveza casera

Nota: Próximamente habrá soporte para otras plataformas (Linux, Windows).

Pasos de instalación

Pasos de actualización

Uso de la línea de comandos

El proyecto proporciona una herramienta de línea de comandos gbox para administrar contenedores sandbox:

Montajes de volumen

El comando gbox box create admite montajes de volúmenes compatibles con Docker mediante el parámetro -v o --volume . Esto permite compartir archivos y directorios entre el sistema host y los contenedores sandbox.

La sintaxis de montaje de volumen sigue este formato:

Dónde:

• /host/path : Ruta a un archivo o directorio en su sistema host
• /container/path : Ruta donde se montará el archivo o directorio en el contenedor
• ro (opcional): hace que el montaje sea de solo lectura
• propagation (opcional): establece el modo de propagación de montaje (privado, rprivate, compartido, rshared, esclavo, rslave)

Ejemplos:

Nota: La ruta del host debe existir antes de crear el contenedor. Si no existe, se creará automáticamente.

Casos de uso de MCP

Su cliente de IA, como Claude Desktop, puede usar gbox MCP para ofrecer mejores resultados, como

1. Generación de diagramas

Generar diagramas de los precios de las acciones de Tesla: https://claude.ai/share/34de8ca3-4e04-441b-9e79-5875fa9fc97a

2. Generación de archivos PDF

Generar PDF de las últimas noticias sobre IA: https://claude.ai/share/84600933-dcf2-44be-a2fd-7f49540db57a

3. Análisis y cálculo

Analizar y comparar la capitalización de mercado de Nvidia/Tesla: https://claude.ai/share/70c335b7-9fff-4ee7-8459-e6b7462d8994

4. Procesamiento de archivos locales

Busque imágenes en la carpeta de descarga y comprímalas en zip. https://claude.ai/share/f8c4c617-9b32-4062-a8e2-2ab33ef46f42

5. Ejecutar tareas arbitrarias

Descargar vídeo de youtube: https://claude.ai/share/c2ab6bcb-7032-489f-87d5-cc38f72c2ca9

Desarrollar gbox

Prerrequisitos

• Vaya a 1.21 o posterior
• Escritorio Docker
• Hacer
• pnpm (a través de corepack)
• Node.js 16.13 o posterior

Construir

Servicios en ejecución

Contribuyendo

¡Agradecemos tus contribuciones! No dudes en enviar una solicitud de incorporación de cambios. Para cambios importantes, primero abre una incidencia para comentar qué te gustaría cambiar.

1. Bifurcar el repositorio
2. Crea tu rama de funciones ( git checkout -b username/feature-name )
3. Confirme sus cambios ( git commit -m 'Add some feature' )
4. Empujar a la rama ( git push origin username/feature-name )
5. Abrir una solicitud de extracción

Cosas que debe saber sobre el desarrollo y la depuración local

Cómo ejecutar gbox en el entorno de desarrollo en lugar del instalado en el sistema

1. Detenga el gbox instalado mediante gbox cleanup . Esto detendrá el servidor API para que pueda ejecutarlo en el entorno de desarrollo.
2. Ejecute make api-dev en la raíz del proyecto.
3. Ejecute ./gbox box list , este es el comando que se ejecuta desde su entorno de desarrollo.

Cómo conectar un cliente MCP como Claude Desktop al servidor MCP en el entorno de desarrollo

1. Ejecute make mcp-dev en la raíz del proyecto.
2. Ejecute ./gbox mcp export --merge-to claude

Cómo abrir la inspección de MCP

1. Ejecute make mcp-inspect en la raíz del proyecto.
2. Haga clic en el enlace que aparece en la terminal.

Cómo crear y usar imágenes en el entorno de desarrollo

1. Ejecute make build-image-python en la raíz del proyecto para construir una imagen de Python, o make build-images para construir todas las imágenes.
2. Cambie el nombre de la imagen según sea necesario (por ejemplo, make build-image-typescript para la imagen TypeScript).
3. Es posible que tengas que eliminar los entornos sandbox actuales para que la nueva imagen sea efectiva ./gbox box delete --all

¿Por qué el cliente MCP aún obtiene el contenido antiguo de MCP?

1. Después de cambiar la configuración de MCP, como las definiciones de herramientas, debe ejecutar make build para actualizar el archivo dist/index.js .
2. Es posible que también necesites ejecutar ./gbox mcp export --merge-to claude

Licencia

Este proyecto está licenciado bajo la Licencia Apache 2.0: consulte el archivo de LICENCIA para obtener más detalles.