302 Sandbox MCP ServerFeatured

@302ai

Repository

Basic information

About 302 Sandbox MCP Server

Create a remote sandbox that can execute code/run commands/upload and download files.

#302ai#sandbox #mcp #server

302 Sandbox MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "302ai-sandbox-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@302ai/sandbox-mcp"
      ],
      "env": {
        "302AI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

302 Sandbox MCP Server tools

Export files from a sandbox directory or file path to downloadable urls. Supports batch export of multiple directories or files. When exporting directories, only common file formats are included (documents, images, audio, video, compressed files, web files, and programming language files).

Query the list of sandboxes associated with the current API key. If no parameters are passed, all current sandboxes will be returned.

Create a Linux sandbox that can execute code, run commands, upload and download files, and has complete Linux functionality. After successful creation, a sandbox_id will be returned, and all subsequent operations will need to include this sandbox_id to specify the corresponding sandbox. After successful creation, the sandbox will automatically pause. When calling other sandbox operation interfaces later, it will automatically reconnect and pause again after execution to avoid generating extra costs.

Destroy a sandbox by its ID.

Automatically creates a sandbox, executes code, and immediately destroys the sandbox after execution. Optionally exports sandbox files (compresses multiple files into a zip archive if there are multiple files in the specified path, or exports a single file directly). Recommended for use cases that don't require continuous sandbox operations.

Import files from public URLs or base64 data into a sandbox. Supports batch import of multiple files. If the target file already exists, it will be overwritten. If the target directory doesn't exist, it will be automatically created. You must create a sandbox before calling this tool.

Run a command line command on a specific linux sandbox. This returns text output only. For operations that generate files, you'll need to use separate file viewing and download endpoints.

Run code on a specific sandbox. This returns text output only. For operations that generate files, you'll need to use separate file viewing and export endpoints. Default file saving path is /home/user.

List files and directories at specified paths within a sandbox. Supports batch queries with multiple paths. This operation can be used before downloadSandboxFiles to check if the file exists.

Overview

What is 302_sandbox_mcp?

302_sandbox_mcp is an MCP (Model Context Protocol) server that provides a secure code sandbox, enabling AI assistants to safely execute arbitrary code. It offers tools for sandbox management, code execution, file operations, and command-line execution, and supports dynamic tool loading.

How to use 302_sandbox_mcp?

Install the server via the npm package @302ai/sandbox-mcp and configure it with your 302AI_API_KEY in your MCP client (e.g., Claude Desktop, Cherry Studio, or ChatWise). The server can run in stdin mode locally or be hosted as a remote HTTP server.

Key features of 302_sandbox_mcp

Dynamic loading of tool list from remote server.
Supports both local stdin and remote HTTP modes.
Create, list, and destroy isolated sandboxes.
Execute arbitrary code with one-click or run-code tool.
Run command-line instructions inside the sandbox.
Import and export files to and from the sandbox.

Use cases of 302_sandbox_mcp

Safely executing code generated by an AI assistant.
Running interactive command-line tasks in a sandboxed environment.
Transferring files into and out of a secure sandbox for analysis.
Automating code testing or data processing via MCP-compatible clients.

Frequently asked questions

What API key is required?

You need a `302AI_API_KEY`, which you can obtain from [302.AI’s API list page](https://dash.302.ai/apis/list).

Which MCP clients are supported?

The server works with Claude Desktop, Cherry Studio, ChatWise, and any MCP-compatible client. Example configurations for each are provided in the README.

How can I debug the server?

Use the MCP Inspector by running `npm run inspector` after installing dependencies.

What modes does the server support?

It supports two modes: `stdin` mode for local usage and a remote HTTP server mode for hosted deployments.

Is the tool list fixed or dynamic?

The tool list is dynamically loaded from a remote server, so new tools can be added without updating the client configuration.

Comments

More Reasoning MCP servers

Emergency Medicare Management MCP Server

manolaz

emergency-medicare-planner-mcp-server

Agentic Tools MCP Server

Pimzino

A comprehensive Model Context Protocol (MCP) server providing AI assistants with powerful task management and agent memories capabilities with project-specific storage.

ArduPilot MCP Server Sandbox

hfujikawa77

ArduPilotドローンをAIエージェントから操作するMCPサーバーです。

MCP Servers

junfanz1

This project demonstrates a decoupled real-time agent architecture that connects LangGraph agents to remote tools served by custom MCP (Modular Command Protocol) servers. The architecture enables a flexible and scalable multi-agent system where each tool can be hosted independent

Agentic Radar

splx-ai

A security scanner for your LLM agentic workflows

993