MCP ExplorerExplorer

302AI Sandbox MCP Server

@302aion 14 days ago
15Β MIT
FreeCommunity
Dev Tools
#code execution#sandbox#MCP#AI tools#code sandbox#development tools
Here is a concise description paragraph focused on what the project does: The 302AI Sandbox MCP Server is an MCP service that provides a secure code sandbox environment, allowing AI assistants to safely execute arbitrary code from various programming languages and tools without compromising system security.

Overview

What is 302AI Sandbox MCP Server

302AI Sandbox MCP Server is a service that enables AI assistants to safely execute arbitrary code in a controlled environment, integrating various AI capabilities for development and deployment.

Use cases

It can be utilized for one-click code execution, sandbox creation, running commands, and managing files within the sandbox, making it suitable for software development, testing, and educational purposes.

How to use

Users install the server as an MCP by configuring it in the appropriate application settings (e.g., Claude Desktop, Cherry Studio, ChatWise) and providing necessary API keys to enable functionality. Development involves setting up dependencies and running build commands.

Key features

The server offers dynamic loading of tool lists, multiple modes for local or remote server use, and a comprehensive API for managing code execution and files within the sandbox environment.

Where to use

It is designed to work with desktop AI applications like Claude, Cherry Studio, and ChatWise, making it versatile for developers looking to integrate AI functionalities into their workflows.

Content

πŸ€– 302AI Sandbox MCP ServerπŸš€βœ¨

An MCP service with code sandbox that allows AI assistants to safely execute arbitrary code.

δΈ­ζ–‡ | English | ζ—₯本θͺž

Previews

Here are some usage examples

Here is the list of supported tools

✨ Features ✨

  • πŸ”§ Dynamic Loading - Automatically update tool list from remote server.
  • 🌐 Multi modes supported, you can use stdin mode locally, or host it as a remote HTTP server

πŸš€ Tool List

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

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

To use with Cherry Studio, add the server config:

{
  "mcpServers": {
    "Li2ZXXJkvhAALyKOFeO4N": {
      "name": "302ai-sandbox-mcp",
      "description": "",
      "isActive": true,
      "registryUrl": "",
      "command": "npx",
      "args": [
        "-y",
        "@302ai/[email protected]"
      ],
      "env": {
        "302AI_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

To use with ChatWise, copy the following content to clipboard

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

Go to Settings -> Tools -> Add button -> Select Import from Clipboard

Find Your 302AI_API_KEY here

Using Tutorials

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

✨ About 302.AI ✨

302.AI is an enterprise-oriented AI application platform that offers pay-as-you-go services, ready-to-use solutions, and an open-source ecosystem.✨

  1. 🧠 Integrates the latest and most comprehensive AI capabilities and brands, including but not limited to language models, image models, voice models, and video models.
  2. πŸš€ Develops deep applications based on foundation models - we develop real AI products, not just simple chatbots
  3. πŸ’° Zero monthly fee, all features are pay-per-use, fully open, achieving truly low barriers with high potential.
  4. πŸ›  Powerful management backend for teams and SMEs - one person manages, many people use.
  5. πŸ”— All AI capabilities provide API access, all tools are open source and customizable (in progress).
  6. πŸ’‘ Strong development team, launching 2-3 new applications weekly, products updated daily. Developers interested in joining are welcome to contact us.

Tools

downloadSandboxFiles
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).
listSandboxes
Query the list of sandboxes associated with the current API key. If no parameters are passed, all current sandboxes will be returned.
createSandbox
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.
killSandbox
Destroy a sandbox by its ID.
directRunCode
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.
writeSandboxFiles
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.
runCommand
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.
runCode
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.
listSandboxFiles
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.

Comments