Arrakis MCP Server

What is Arrakis MCP Server?

The Arrakis MCP Server is a Model Context Protocol (MCP) server that exposes Arrakis VM sandbox functionality to Large Language Models. It allows LLMs to manage virtual machines, run commands, upload/download files, and control VM state via MCP tools and resources.

How to use Arrakis MCP Server?

Clone the repository, then configure your LLM tool to use the Arrakis MCP server by adding it to your MCP configuration with uv as the command and arrakis_mcp_server.py as the entry point. After setup, the server provides MCP resources and tools for VM management.

Key features of Arrakis MCP Server

• List all available VMs via arrakis://vms resource.
• Get details about a specific VM via arrakis://vm/{vm_name}.
• Start, snapshot, restore, and destroy VMs.
• Run commands inside a VM sandbox.
• Upload and download files to/from a VM.
• Pause or stop a VM with update_vm_state.

Use cases of Arrakis MCP Server

• An LLM agent creating isolated sandbox environments for code execution.
• Automated testing across multiple VM snapshots.
• Deploying and managing temporary demo or development VMs.
• Running commands or scripts in a controlled environment via natural language.

FAQ from Arrakis MCP Server

How do I set up the Arrakis MCP server?

Clone the repository and add the following to your MCP client configuration: "arrakis": { "command": "<path-to-uv>", "args": ["--directory", "<path-to-repo>", "run", "arrakis_mcp_server.py"] }.

What tools does Arrakis MCP Server provide?

It provides tools: start_sandbox, restore_snapshot, snapshot, run_command, upload_file, download_file, destroy_vm, destroy_all_vms, and update_vm_state.

What resources does Arrakis MCP Server expose?

Two resources: arrakis://vms (list all VMs) and arrakis://vm/{vm_name} (get specific VM information).

What license is Arrakis MCP Server under?

It is licensed under the GNU Affero General Public License v3.0.