{"id":27693187,"url":"https://github.com/pottekkat/sandbox-mcp","last_synced_at":"2026-05-10T02:46:07.459Z","repository":{"id":289223989,"uuid":"969953611","full_name":"pottekkat/sandbox-mcp","owner":"pottekkat","description":"Allow LLMs to run ANY code/configuration safely in isolated Docker sandboxes using the Model Context Protocol (MCP).","archived":false,"fork":false,"pushed_at":"2025-04-22T07:43:20.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-22T07:48:19.630Z","etag":null,"topics":["docker","go","golang","mcp","mcp-server","model-context-protocol","model-context-protocol-servers","sandbox"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pottekkat.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-21T07:55:50.000Z","updated_at":"2025-04-22T07:43:24.000Z","dependencies_parsed_at":"2025-04-22T07:48:31.832Z","dependency_job_id":"d14447e5-d709-4c53-b90e-9f7a3e3b52f6","html_url":"https://github.com/pottekkat/sandbox-mcp","commit_stats":null,"previous_names":["pottekkat/sandbox-mcp"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pottekkat%2Fsandbox-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pottekkat%2Fsandbox-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pottekkat%2Fsandbox-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pottekkat%2Fsandbox-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pottekkat","download_url":"https://codeload.github.com/pottekkat/sandbox-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250395252,"owners_count":21423395,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","go","golang","mcp","mcp-server","model-context-protocol","model-context-protocol-servers","sandbox"],"created_at":"2025-04-25T12:55:29.797Z","updated_at":"2026-05-10T02:46:07.391Z","avatar_url":"https://github.com/pottekkat.png","language":"Go","funding_links":[],"categories":["📚 Projects (1974 total)","📦 Other","Security","💻 Code Execution"],"sub_categories":["MCP Servers"],"readme":"![Sandbox MCP Logo](readme-banner.png)\n\n![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/pottekkat/sandbox-mcp/release.yaml)\n![GitHub Release](https://img.shields.io/github/v/release/pottekkat/sandbox-mcp)\n![GitHub commits since latest release](https://img.shields.io/github/commits-since/pottekkat/sandbox-mcp/latest)\n![GitHub License](https://img.shields.io/github/license/pottekkat/sandbox-mcp)\n\n**Sandbox MCP** is a Model Context Protocol (MCP) server that enables LLMs (MCP hosts/clients) to **run code in secure, isolated Docker containers**.\n\nWhile LLMs are really good at generating code, most **can't run the code they generate**. You end up running this untested code directly on your machine, which could have drastic unintended consequences.\n\nGiving LLMs the tools to test the code safely prevents such issues and helps you **generate more accurate code in fewer iterations**.\n\nSandbox MCP gives the LLMs an **easy-to-use execution environment that anyone can create and configure** through a simple, AI-native MCP server that runs locally.\n\n_Inspired by [Codapi](https://codapi.org). Some sandboxes are the same as [Codapi sandboxes](https://github.com/nalgeon/sandboxes)._\n\n## Use Cases\n\nSandbox MCP can be used for many different tasks, including but not limited to:\n\n- **Secure code execution**: Run any code generated by an LLM in a secure, isolated environment, protecting your system from untrusted or potentially harmful code.\n- **Code testing**: Automatically test and validate code in various languages and or configurations in various environments before integrating it into larger projects or production systems.\n- **User code validation**: Safely execute and check user-submitted code or scripts, ensuring they behave as expected and do not perform malicious actions.\n- **Network troubleshooting**: Diagnose connectivity issues, test endpoints, and analyze network performance using isolated network tools, all without exposing your system.\n- **Educational and interview coding**: Instantly compile and run code snippets for learning, teaching, or technical interviews, providing immediate feedback in a safe, temporary environment.\n- **Automated code review and feedback**: Enable LLMs to execute, test, and review code automatically, offering actionable feedback or suggestions before code is merged or deployed.\n\n## Demo\n\nThis demo shows how Sandbox MCP works with Claude Desktop.\n\n![Sandbox MCP demo GIF](demo.gif)\n\nTry the [video](demo.mp4) if the GIF isn't clear.\n\n## Installation\n\n### Download Binary\n\nYou can download the appropriate binary for your operating system (for example, `Darwin`) and processor architecture (`arm64`) from the [Releases page](https://github.com/pottekkat/sandbox-mcp/releases) (`sandbox-mcp_Darwin_arm64.tar.gz`).\n\n### Install via Go\n\nPrerequisites:\n\n- Go 1.24 or higher\n\n```bash\ngo install github.com/pottekkat/sandbox-mcp/cmd/sandbox-mcp@latest\n```\n\nGet the path to the `sandbox-mcp` binary:\n\n```bash\nwhich sandbox-mcp\n```\n\n### Build from Source\n\nSee the [Development section](#development).\n\n## Usage\n\n### Initilization\n\nBefore you use `sandbox-mcp` with LLMs, you need to initialize its configuration:\n\n```bash\n# Create the configuration directory in\n# $XDG_CONFIG_HOME/sandbox-mcp and pull\n# the default sandboxes from GitHub\nsandbox-mcp --pull\n\n# Build the Docker images for the sandboxes\nsandbox-mcp --build\n```\n\n\u003e [!NOTE]\n\u003e Make sure you have Docker installed and running.\n\n### With MCP Hosts/Clients\n\nAdd this to your `claude_desktop_config.json` for Claude Desktop or `mcp.json` for Cursor IDE:\n\n```json\n{\n    \"mcpServers\": {\n        \"sandbox-mcp\": {\n            \"command\": \"path/to/sandbox-mcp\",\n            \"args\": [\n                \"--stdio\"\n            ]\n        }\n    }\n}\n```\n\n\u003e [!NOTE]\n\u003e Make sure to replace `path/to/sandbox-mcp` with the actual path to the `sandbox-mcp` binary.\n\n## Available Sandboxes\n\n| Sandbox | Description |\n|---------|-------------|\n| [shell](/sandboxes/shell) | A secure, isolated Linux environment for running lightweight commands that does not require network access. |\n| [python](/sandboxes/python) | Safely execute Python code in a secure, isolated environment. |\n| [rust](/sandboxes/rust) | Compile and run Rust code in an isolated environment. |\n| [network-tools](/sandboxes/network-tools) | Use various network utilities in an isolated Linux sandbox. Perfect for network diagnostics and troubleshooting. See https://github.com/jonlabelle/docker-network-tools for a list of available tools. |\n| [go](/sandboxes/go) | Run Go code securely in an isolated environment with network access. |\n| [javascript](/sandboxes/javascript) | Run JavaScript code in an isolated environment using Node.js. |\n| [apisix](/sandboxes/apisix) | Run a lightweight instance of Apache APISIX, which can be configured through a YAML file and can be interacted through the curl command provided in the main.sh file. For example, curl -sI `http://127.0.0.1:9080/ip`. |\n| [java](/sandboxes/java) | Compile and run Java code in an isolated sandbox. Supports Java preview features. |\n\n\u003e [!IMPORTANT]\n\u003e ### Your Own Sandbox\n\u003e \n\u003e You can create and add your own sandboxes in `$XDG_CONFIG_HOME/sandbox-mcp/sandboxes`. A sandbox is essentially a Dockerfile and a JSON configuration. Check out the [examples and the guide](/sandboxes) to learn more.\n\n## Development\n\nFork and clone the repository:\n\n```bash\ngit clone https://github.com/username/sandbox-mcp.git\n```\n\nChange into the directory:\n\n```bash\ncd sandbox-mcp\n```\n\nInstall dependencies:\n\n```bash\nmake deps\n```\n\nBuild the project:\n\n```bash\nmake build\n```\n\nUpdate your MCP servers configuration to point to the local build:\n\n```json\n{\n    \"mcpServers\": {\n        \"sandbox-mcp\": {\n            \"command\": \"/path/to/sandbox-mcp/dist/sandbox-mcp\",\n            \"args\": [\n                \"--stdio\"\n            ]\n        }\n    }\n}\n```\n\n## License\n\n[MIT License](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpottekkat%2Fsandbox-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpottekkat%2Fsandbox-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpottekkat%2Fsandbox-mcp/lists"}