# Onlyboxes MCP server

> Lets an AI client run Python code, use stateful terminal sessions, and read generated images in a self-hosted sandbox.

- Repository: https://github.com/Coooolfan/onlyboxes
- Page: https://hostedmcp.org/servers/coooolfan/onlyboxes
- Transport: —
- Stars: 54
- License: AGPL-3.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `WORKER_CONSOLE_GRPC_TARGET` | no | no |  |
| `WORKER_CONSOLE_INSECURE` | no | no |  |
| `WORKER_ID` | no | no |  |
| `WORKER_SECRET` | no | no |  |

## FAQ

### What MCP tools does Onlyboxes provide?

It exposes pythonExec for Python code execution, terminalExec for stateful terminal sessions, and readImage for model-readable images.

### Why does my worker stay offline after starting?

Check that WORKER_CONSOLE_GRPC_TARGET points to the correct console gRPC address and verify network connectivity.

### Can a worker be deployed on the same machine as the console?

Yes, a worker can run on the same machine as the console, though production guidance recommends isolated hosts.

### Does Onlyboxes provide TLS out of the box?

No, the current release has no built-in TLS/mTLS on the console. Put both console HTTP and gRPC endpoints behind a reverse proxy or gateway and enforce TLS there.
