code-sandbox-mcp
An MCP server to create secure code sandbox environment for executing code within Docker containers. This MCP server provides AI applications with a safe and isolated environment for running code while maintaining security through containerization.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/automata-labs-team--code-sandbox-mcp)HTML
<a href="/listings/automata-labs-team--code-sandbox-mcp"><img src="/api/listings/automata-labs-team--code-sandbox-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
Prerequisites
- Docker installed and running - [Install Docker for Linux](https://docs.docker.com/engine/install/) - [Install Docker Desktop for macOS](https://docs.docker.com/desktop/install/mac/) - [Install Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)
Quick Install
Linux, MacOS
curl -fsSL https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.sh | bash
Windows
# Run in PowerShell irm https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.ps1 | iex
The installer will: 1. Check for Docker installation 2. Download the appropriate binary for your system 3. Create necessary configuration files
Manual Installation
1. Download the latest release for your platform from the [releases page](https://github.com/Automata-Labs-team/code-sandbox-mcp/releases) 2. Place the binary in a directory in your PATH 3. Make it executable (Unix-like systems only):
chmod +x code-sandbox-mcp
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 179 lines · 2 findings marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Code Sandbox MCP 🐳
- [](https://smithery.ai/server/@Automata-Labs-team/code-sandbox-mcp)
- A secure sandbox environment for executing code within Docker containers. This MCP server provides AI applications with a safe and isolated environment for running code while maintaining security through containerization.
- ## 🌟 Features
- - **Flexible Container Management**: Create and manage isolated Docker containers for code execution
- - **Custom Environment Support**: Use any Docker image as your execution environment
- - **File Operations**: Easy file and directory transfer between host and containers
- - **Command Execution**: Run any shell commands within the containerized environment
- - **Real-time Logging**: Stream container logs and command output in real-time
- - **Auto-Updates**: Built-in update checking and automatic binary updates
- - **Multi-Platform**: Supports Linux, macOS, and Windows
- ## 🚀 Installation
- ### Prerequisites
- - Docker installed and running
- - [Install Docker for Linux](https://docs.docker.com/engine/install/)
- - [Install Docker Desktop for macOS](https://docs.docker.com/desktop/install/mac/)
- - [Install Docker Desktop for Windows](https://docs.docker.com/desktop/install/windows-install/)
- ### Quick Install
- #### Linux, MacOS
- ```bash
- curl -fsSL https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 29 on GitHub
- ```
- #### Windows
- ```powershell
- # Run in PowerShell
- irm https://raw.githubusercontent.com/Automata-Labs-team/code-sandbox-mcp/main/install.ps1 | iex
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 35 on GitHub
- ```
- The installer will:
- 1. Check for Docker installation
- 2. Download the appropriate binary for your system
- 3. Create necessary configuration files
- ### Manual Installation
- 1. Download the latest release for your platform from the [releases page](https://github.com/Automata-Labs-team/code-sandbox-mcp/releases)
- 2. Place the binary in a directory in your PATH
- 3. Make it executable (Unix-like systems only):
- ```bash
- chmod +x code-sandbox-mcp
- ```
- ## 🛠️ Available Tools
- #### `sandbox_initialize`
- Initialize a new compute environment for code execution.
- Creates a container based on the specified Docker image.
- **Parameters:**
- - `image` (string, optional): Docker image to use as the base environment
- - Default: 'python:3.12-slim-bookworm'
- **Returns:**
- - `container_id` that can be used with other tools to interact with this environment
- #### `copy_project`
- Copy a directory to the sandboxed filesystem.
- **Parameters:**
- - `container_id` (string, required): ID of the container returned from the initialize call
- - `local_src_dir` (string, required): Path to a directory in the local file system
- - `dest_dir` (string, optional): Path to save the src directory in the sandbox environment
- #### `write_file`
- Write a file to the sandboxed filesystem.
- **Parameters:**
- - `container_id` (string, required): ID of the container returned from the initialize call
- - `file_name` (string, required): Name of the file to create
- - `file_contents` (string, required): Contents to write to the file
- - `dest_dir` (string, optional): Directory to create the file in (Default: ${WORKDIR})
- #### `sandbox_exec`
- Execute commands in the sandboxed environment.
- **Parameters:**
- - `container_id` (string, required): ID of the container returned from the initialize call
- - `commands` (array, required): List of command(s) to run in the sandboxed environment
- - Example: ["apt-get update", "pip install numpy", "python script.py"]
- #### `copy_file`
- Copy a single file to the sandboxed filesystem.
- **Parameters:**
- - `container_id` (string, required): ID of the container returned from the initialize call
- - `local_src_file` (string, required): Path to a file in the local file system
- - `dest_path` (string, optional): Path to save the file in the sandbox environment
- #### `sandbox_stop`
- Stop and remove a running container sandbox.
- **Parameters:**
- - `container_id` (string, required): ID of the container to stop and remove
- **Description:**
- Gracefully stops the specified container with a 10-second timeout and removes it along with its volumes.
- #### Container Logs Resource
- A dynamic resource that provides access to container logs.
- **Resource Path:** `containers://{id}/logs`
- **MIME Type:** `text/plain`
- **Description:** Returns all container logs from the specified container as a single text resource.
- ## 🔐 Security Features
- - Isolated execution environment using Docker containers
- - Resource limitations through Docker container constraints
- - Separate stdout and stderr streams
- ## 🔧 Configuration
- ### Claude Desktop
- The installer automatically creates the configuration file. If you need to manually configure it:
- #### Linux
- ```json
- // ~/.config/Claude/claude_desktop_config.json
- {
- "mcpServers": {
- "code-sandbox-mcp": {
- "command": "/path/to/code-sandbox-mcp",
- "args": [],
- "env": {}
- }
- }
- }
- ```
- #### macOS
- ```json
- // ~/Library/Application Support/Claude/claude_desktop_config.json
- {
- "mcpServers": {
- "code-sandbox-mcp": {
- "command": "/path/to/code-sandbox-mcp",
- "args": [],
- "env": {}
- }
- }
- }
- ```
- #### Windows
- ```json
- // %APPDATA%\Claude\claude_desktop_config.json
- {
- "mcpServers": {
- "code-sandbox-mcp": {
- "command": "C:\\path\\to\\code-sandbox-mcp.exe",
- "args": [],
- "env": {}
- }
- }
- }
- ```
- ### Other AI Applications
- For other AI applications that support MCP servers, configure them to use the `code-sandbox-mcp` binary as their code execution backend.
- ## 🛠️ Development
- If you want to build the project locally or contribute to its development, see [DEVELOPMENT.md](DEVELOPMENT.md).
- ## 📝 License
- This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.