Code Execution Server
This repository provides a basic implementation of a code execution server, designed primarily for Xmaster (paper, code) and Browse Master (paper code). The full implementation is used in SciMaster.
Due to the proprietary nature of the full code, this repository only includes an open-source framework and the basic components required for code execution. It also includes a simple network search tool implementation.
⚠️ Warning: This is a basic code execution server without virtualization or safety protections. For added security, consider running it within Docker or Apptainer containers as necessary.
🛠️ Setup
Environment
Clone this repository and navigate to the project directory and install the required dependencies:
cd mcp_sandbox/
pip install -r requirements.txt
Tools
- setup the serper key in
configs/web_agent.json - setup the models' api key in
configs/llm_call.json
🚀 Deploy the Code Execution Server
Step 1: Start the API Server
We will first start the API server used by the tools. This API server proxies all search-related services, including:
- Serper's Google Search Service
- A series of Model APIs
Navigate to the api_proxy directory and start the API server:
cd api_proxy
python api_server.py
Step 2: Deploy the Server
Deploy the server by running the following script in the MCP directory:
cd MCP
bash deploy_server.sh
📝 Usage
Sending a Request
To send a request to the server, use the following curl command:
curl -X POST "http://<your-server-url>/execute" \
-H "Content-Type: application/json" \
-d '{"code": "<your code here>"}'
⚡ Benchmarking
For benchmarking, you can run the following command to test the server's performance:
bash benchmarking/pressure.sh 100 100 10 benchmarking/script.lua http://127.0.0.1:30008
Example output:
Running 10s test @ http://127.0.0.1:30008/execute
100 threads and 100 connections
Thread Stats Avg Stdev Max +/- Stdev
Latency 50.21ms 47.15ms 296.96ms 53.20%
Req/Sec 24.13 13.58 130.00 54.99%
23185 requests in 10.10s, 4.27MB read
Requests/sec: 2295.61
Transfer/sec: 432.74KB