bigppwong avatar

EdgeBox

bigppwong/edgebox

EdgeBox is a local desktop sandbox application that provides AI agents with both command-line shell and full graphical desktop environment access through an integrated VNC viewer, enabling "Computer Use" capabilities like browser operation and application interaction. The server implements the Model Context Protocol (MCP) and provides tools for code execution, desktop automation, and system interaction, solving the problem of sandboxing and controlling AI agent actions on local machines while maintaining data privacy and near-zero latency compared to cloud-based alternatives. EdgeBox differentiates itself from other open-source sandbox projects by offering GUI-powered desktop capabilities alongside traditional CLI execution, transforming LLM agents from simple code executors into digital workers capable of performing complex desktop tasks.

GitHub stars
201
tools
33
last updated
Jan 17, 2026

Tools

33 tools

Public tool metadata for what this MCP can expose to an agent.

execute_pythonExecute Python code in isolated environment

Execute Python code in isolated environment

No parameter schema in public metadata yet.

execute_typescriptExecute TypeScript/JavaScript code

Execute TypeScript/JavaScript code

No parameter schema in public metadata yet.

execute_rExecute R code for statistical analysis

Execute R code for statistical analysis

No parameter schema in public metadata yet.

execute_javaExecute Java code

Execute Java code

No parameter schema in public metadata yet.

execute_bashExecute Bash scripts

Execute Bash scripts

No parameter schema in public metadata yet.

shell_runRun shell commands (stateful, persistent environment)

Run shell commands (stateful, persistent environment)

No parameter schema in public metadata yet.

shell_run_backgroundRun commands in background with process management

Run commands in background with process management

No parameter schema in public metadata yet.

fs_listList files in directories

List files in directories

No parameter schema in public metadata yet.

fs_readRead file contents

Read file contents

No parameter schema in public metadata yet.

fs_writeWrite content to files

Write content to files

No parameter schema in public metadata yet.

fs_infoGet file metadata and information

Get file metadata and information

No parameter schema in public metadata yet.

fs_watchMonitor directory changes in real-time

Monitor directory changes in real-time

No parameter schema in public metadata yet.

desktop_mouse_clickPerform mouse clicks (left/right/middle)

Perform mouse clicks (left/right/middle)

No parameter schema in public metadata yet.

desktop_mouse_double_clickDouble-click actions

Double-click actions

No parameter schema in public metadata yet.

desktop_mouse_moveMove cursor to coordinates

Move cursor to coordinates

No parameter schema in public metadata yet.

desktop_mouse_scrollScroll up/down with configurable amount

Scroll up/down with configurable amount

No parameter schema in public metadata yet.

desktop_mouse_dragDrag from one position to another

Drag from one position to another

No parameter schema in public metadata yet.

desktop_keyboard_typeType text with clipboard support for non-ASCII

Type text with clipboard support for non-ASCII

No parameter schema in public metadata yet.

desktop_keyboard_pressPress specific keys (Return, Escape, Tab, etc.)

Press specific keys (Return, Escape, Tab, etc.)

No parameter schema in public metadata yet.

desktop_keyboard_comboExecute key combinations (Ctrl+C, Alt+Tab, etc.)

Execute key combinations (Ctrl+C, Alt+Tab, etc.)

No parameter schema in public metadata yet.

desktop_get_windowsList all windows with titles and IDs

List all windows with titles and IDs

No parameter schema in public metadata yet.

desktop_switch_windowFocus specific windows

Focus specific windows

No parameter schema in public metadata yet.

desktop_maximize_windowMaximize windows

Maximize windows

No parameter schema in public metadata yet.

desktop_minimize_windowMinimize windows

Minimize windows

No parameter schema in public metadata yet.

desktop_resize_windowResize windows to specific dimensions

Resize windows to specific dimensions

No parameter schema in public metadata yet.

desktop_screenshotCapture desktop screenshots (PNG format)

Capture desktop screenshots (PNG format)

No parameter schema in public metadata yet.

desktop_launch_appLaunch applications by name

Launch applications by name

No parameter schema in public metadata yet.

desktop_waitAdd delays between actions

Add delays between actions

No parameter schema in public metadata yet.

container_list

No parameter schema in public metadata yet.

container_create

No parameter schema in public metadata yet.

container_stop

No parameter schema in public metadata yet.

container_restart

No parameter schema in public metadata yet.

container_delete

No parameter schema in public metadata yet.

Sponsors

Readme

EdgeBox - The Local Desktop Sandbox for AI Agents

Release 简体中文

💡 新项目推荐: 如果你需要更轻量化的内核级沙箱方案,查看 DAIMON —— 一个专为 AI Agent 设计的轻量级本地沙箱运行时。DAIMON 采用 Rust 编写,基于 Linux Landlock LSM 和 seccomp 实现 OS 内核级强制沙箱,提供细粒度的文件系统访问控制、网络隔离和非特权用户身份执行。相比传统 Docker 容器方案更加轻量,适合 MCP Server 的安全执行环境。

EdgeBox Logo
A fully-featured, GUI-powered local LLM Agent sandbox with complete support for the MCP protocol.

Empower your Large Language Models (LLMs) with true "Computer Use" capabilities.



View the full README on GitHub

Details

Repository
github.com/bigppwong/edgebox