LLM Python Code Sandbox
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@LLM Python Code SandboxCreate a sandbox and run a Python script to analyze sales data."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
LLM Python Code Sandbox ๐
Self-Hosting an E2B-like coding playground
Logo | Description |
A Python code sandbox HTTP service crafted for LLMs, enabling isolated Python execution environments with code execution, file operations, and MCP integration. ๐๏ธ | |
๐ Awesome Features
Create Sandbox ๐: Spin up a Jupyter kernel and get a unique ID in a flash! โก
Execute Code ๐ป: Run code in a specified Jupyter kernel and receive stdout, stderr, errors, tracebacks, and even binary files like images. Supports Multi-Round Code Execution for complex workflows! ๐จ
File Operations ๐: Upload files to the sandbox workspace and download files from it seamlessly. ๐ค๐ฅ
Close Sandbox ๐๏ธ: Safely shut down sandboxes and clean up resources when you're done. โป๏ธ
Sandbox Isolation ๐: Each sandbox has its own Python virtual environment and working directory to prevent package conflicts. ๐ก๏ธ
Auto-Cleanup ๐งน: Sandboxes automatically close after 24 hours with hourly cleanup of expired ones. No messy leftovers! ๐ฟ
Virtual Environment Mirror ๐ช: Service auto-creates a base virtual environment image with common packages on startup, making new sandbox initialization super fast! โก
MCP Support ๐ค: Integrated with FastAPI-MCP, allowing the service to be directly called by AI models. ๐ค
๐ Getting Started
Install Dependencies
Run this command in your project directory to install all required packages:
cd sandbox
pip install -r requirements.txtStart the Service
Launch the sandbox service with this simple command:
python main.py --host 0.0.0.0 --port 8000The service will be up and running at http://0.0.0.0:8000 ๐
๐ฑ Sandbox Client (E2B-like)
You can directly use the SandboxClient to interact with the sandbox service!
Basic Usage
# Create client instance
client = SandboxClient(base_url='http://0.0.0.0:8000')
# Create a new sandbox
sandbox_id = client.create_sandbox()
# Execute some code
client.execute_code("print('Hello, Sandbox! ๐')")
# Install required Python packages in the sandbox's virtual environment
client.install_package("numpy")
# View generated files
files = client.list_files()
# Download a generated CSV file
csv_file = next((f for f in files if f['path'].endswith('.csv')), None)
client.download_file(csv_file['path'])
# Upload a local file to the sandbox
client.upload_file('test_upload.txt')
# Close the sandbox when finished
client.close_sandbox()
# Check if all sandboxes are closed
client.list_all_sandboxes()Multi-Round Code Execution Example ๐ญ
The sandbox supports executing multiple code blocks in the same session, preserving state between executions. Perfect for building complex programs step by step! ๐งฉ
# Create client and sandbox
client = SandboxClient(base_url='http://0.0.0.0:8000')
client.create_sandbox()
# Step 1: Import libraries and define initial data
client.execute_code("""import numpy as np
import pandas as pd
# Create sample data
data = {
'Name': ['Alice', 'Bob', 'Charlie', 'David'],
'Age': [28, 32, 45, 36],
'Salary': [8000, 12000, 15000, 9000]
}
# Create DataFrame
df = pd.DataFrame(data)
print(df)""")
# Step 2: Data processing and analysis (using data defined in step 1)
client.execute_code("""# Calculate average age and salary
avg_age = df['Age'].mean()
avg_salary = df['Salary'].mean()
print(f"Average Age: {avg_age:.1f}")
print(f"Average Salary: ${avg_age:.2f}")
# Add a new column
df['Age Group'] = pd.cut(df['Age'], bins=[20, 30, 40, 50], labels=['20-30s', '30-40s', '40-50s'])
print(df)""")
# Step 3: Save processed data
client.execute_code("""# Save to CSV file
df.to_csv('processed_data.csv', index=False)
print("Data saved to processed_data.csv ๐พ")
""")
# Download the generated file
files = client.list_files()
csv_file = next((f for f in files if f['path'] == 'processed_data.csv'), None)
if csv_file:
client.download_file(csv_file['path'])
# Close the sandbox
client.close_sandbox()Matplotlib Plot Capture Example ๐จ
The sandbox can capture matplotlib plots and return them as image data, perfect for displaying or saving visualizations! ๐
# Create client and sandbox
client = SandboxClient(base_url='http://0.0.0.0:8000')
client.create_sandbox()
# Install required packages (if not in base environment)
client.install_package("matplotlib")
client.install_package("numpy")
# Execute plotting code
result = client.execute_code("""import numpy as np
import matplotlib.pyplot as plt
# Generate data
x = np.linspace(0, 10, 100)
y1 = np.sin(x)
y2 = np.cos(x)
# Create plot
plt.figure(figsize=(10, 6))
plt.plot(x, y1, label='Sine Function')
plt.plot(x, y2, label='Cosine Function')
plt.title('Trigonometric Functions Demo ๐')
plt.xlabel('X-axis')
plt.ylabel('Y-axis')
plt.grid(True)
plt.legend()
plt.tight_layout()
# The sandbox will automatically capture the plot and return image data
""")
# The result will contain image data for the plot, which can be used for display or saving
# Image data is typically stored in result['results'] as base64 encoded strings
# Another way to save the plot as a file
client.execute_code("""# Save the plot to a file
plt.savefig('trigonometric_functions.png', dpi=300, bbox_inches='tight')
print("Plot saved as trigonometric_functions.png ๐จ")
""")
# Download the generated image file
files = client.list_files()
img_file = next((f for f in files if f['path'] == 'trigonometric_functions.png'), None)
if img_file:
client.download_file(img_file['path'])
# Close the sandbox
client.close_sandbox()This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/DSXiangLi/simple_sandbox'
If you have feedback or need assistance with the MCP directory API, please join our Discord server