# E2B MCP Server

An MCP server that exposes the E2B Sandbox API as Model Context Protocol tools.

## Features

The server currently provides tools for:

- **Sandboxes** (`sandbox_create`, `sandbox_connect`, `sandbox_list`, `sandbox_kill`, `sandbox_pause`, `sandbox_set_timeout`, `sandbox_get_info`) — create/connect/list/kill/pause sandboxes and manage their timeout, via the E2B JS SDK (`Sandbox`).
- **Filesystem** (`files_read`, `files_write`, `files_list`, `files_make_dir`, `files_rename`, `files_remove`, `files_exists`, `files_get_info`) — read/write/list/move/remove/stat files via `Sandbox.files`.
- **Commands** (`commands_run`, `commands_connect`, `commands_list`, `commands_send_stdin`, `commands_close_stdin`, `commands_kill`) — run and manage commands via `Sandbox.commands`.
- **PTY** (`pty_create`, `pty_connect`, `pty_send_input`, `pty_resize`, `pty_kill`) — pseudo-terminal sessions via `Sandbox.pty`.

The server is stateless: it authenticates with `E2B_API_KEY` (env) and, for secure sandboxes, replays the `accessToken` returned by `sandbox_create` / `sandbox_connect` on every later call.

Deprecated E2B API endpoints and snapshot-related functionality have been removed from the project.

## Requirements

- Node.js 22 or later
- An E2B API key

## Installation

```bash
npm ci
```

## Configuration

Set your E2B API key in the environment:

```bash
export E2B_API_KEY="your-api-key"
```

## Usage

Start the server with:

```bash
npm start
```

The server is designed to be used as an MCP server over stdio. It can be connected to any MCP-compatible client that supports stdio servers.

## Docker

Build the image:

```bash
docker build -t e2b-mcp-server .
```

Run it:

```bash
docker run --rm -i \
  -e E2B_API_KEY="$E2B_API_KEY" \
  e2b-mcp-server
```

## Development

Check the JavaScript syntax for all source files:

```bash
for f in src/*.js; do node --check "$f"; done
```

Run the smoke test:

```bash
npm run smoke
```

## Project Structure

```text
src/
├── http.js
├── index.js
├── tools-common.js
├── tools-filesystem.js
├── tools-process.js
├── tools-sandboxes.js
└── tools-templates.js
```

## License

ISC