Development Guide 🛠️

This guide is for developers who want to build the project locally or contribute to its development.

Prerequisites

• Go 1.21 or later
• Docker installed and running
• Git (for version information)
• Make (optional, for build automation)

Building from Source

1. Clone the repository:

git clone https://github.com/Automata-Labs-team/code-sandbox-mcp.git
cd code-sandbox-mcp

2. Build the project:

# Development build
./build.sh

# Release build
./build.sh --release

# Release with specific version
./build.sh --release --version v1.0.0

The binaries will be available in the bin directory.

Build Options

The build.sh script supports several options:

Option	Description
--release	Build in release mode with version information
--version <ver>	Specify a version number (e.g., v1.0.0)

Project Structure

code-sandbox-mcp/
├── src/
│   └── code-sandbox-mcp/
│       └── main.go       # Main application code
├── bin/                  # Compiled binaries
├── build.sh             # Build script
├── install.sh           # Unix-like systems installer
├── install.ps1          # Windows installer
├── README.md            # User documentation
└── DEVELOPMENT.md       # This file

API Documentation

The project implements the MCP (Machine Code Protocol) server interface for executing code in Docker containers.

Core Functions

• runInDocker: Executes single-file code in a Docker container
• runProjectInDocker: Runs project directories in containers
• RegisterTool: Registers new tool endpoints
• NewServer: Creates a new MCP server instance

Tool Arguments

RunCodeArguments

type RunCodeArguments struct {
    Code       string   `json:"code"`       // The code to run
    Language   Language `json:"language"`   // Programming language
}

RunProjectArguments

type RunProjectArguments struct {
    ProjectDir string   `json:"project_dir"` // Project directory
    Language   Language `json:"language"`    // Programming language
    Entrypoint string   `json:"entrypoint"` // Command to run the project
    Background bool     `json:"background"`  // Run in background
}