https://github.com/aallam/execbox

JS code execution for MCP, with pluggable runtimes and host-controlled tools.
https://github.com/aallam/execbox

ai-agents code-execution mcp sandbox

Last synced: 13 days ago
JSON representation

JS code execution for MCP, with pluggable runtimes and host-controlled tools.

• Host: GitHub
• URL: https://github.com/aallam/execbox
• Owner: aallam
• License: mit
• Created: 2026-03-31T11:44:48.000Z (about 1 month ago)
• Default Branch: main
• Last Pushed: 2026-04-19T00:49:29.000Z (25 days ago)
• Last Synced: 2026-04-19T02:44:28.804Z (25 days ago)
• Topics: ai-agents, code-execution, mcp, sandbox
• Language: TypeScript
• Homepage: https://execbox.aallam.com
• Size: 317 KB
• Stars: 0
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Security: docs/security.md
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          


# execbox

Portable code execution for [Model Context Protocol](https://modelcontextprotocol.io/) tools and wrapped MCP servers.

[![License](https://img.shields.io/github/license/aallam/execbox?style=flat-square)](https://github.com/aallam/execbox/blob/main/LICENSE)

[![Docs](https://img.shields.io/badge/docs-site-0ea5e9?style=flat-square)](https://execbox.aallam.com)

[![Packages](https://img.shields.io/badge/packages-4-111827?style=flat-square)](#package-map)



Execbox turns host tool catalogs into callable guest namespaces, supports MCP wrapping on both sides of the boundary, and lets you place guest JavaScript where it fits your deployment: inline, behind a worker or child-process host, or across your own remote transport.

## Package Map

| Package                                           | npm                                                                                                                                   | What it is for                                                                                                 |

| ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |

| [`@execbox/core`](./packages/core/)               | [![npm](https://img.shields.io/npm/v/%40execbox%2Fcore?style=flat-square)](https://www.npmjs.com/package/@execbox/core)               | Core execution contract, provider resolution, MCP adapters, and the `@execbox/core/protocol` transport subpath |

| [`@execbox/quickjs`](./packages/quickjs/)         | [![npm](https://img.shields.io/npm/v/%40execbox%2Fquickjs?style=flat-square)](https://www.npmjs.com/package/@execbox/quickjs)         | QuickJS executor for inline, worker, and process hosts                                                         |

| [`@execbox/remote`](./packages/remote/)           | [![npm](https://img.shields.io/npm/v/%40execbox%2Fremote?style=flat-square)](https://www.npmjs.com/package/@execbox/remote)           | Transport-backed remote executor                                                                               |

| [`@execbox/isolated-vm`](./packages/isolated-vm/) | [![npm](https://img.shields.io/npm/v/%40execbox%2Fisolated-vm?style=flat-square)](https://www.npmjs.com/package/@execbox/isolated-vm) | `isolated-vm` backend for execbox                                                                              |

## Examples

Runnable examples live in [`examples/`](./examples/) and are indexed in [`examples/README.md`](./examples/README.md).

## Docs

- [Public Docs](https://execbox.aallam.com)

- [Getting Started Guide](./docs/getting-started.md)

- [Execbox Architecture Overview](./docs/architecture/README.md)