Arrakis Server

A Model Context Protocol (MCP) server that exposes Arrakis VM sandbox functionality to Large Language Models.

Setup

Setup

1. Clone this repository:

   git clone https://github.com/abshkbh/arrakis-mcp-server.git
   cd arrakis-mcp-server
   

2. Configure your LLM tool to use the Arrakis MCP server by adding the following to your MCP configuration:

   "mcpServers": {
       "arrakis": {
           "command": "<path-to-uv>",
           "args": [
               "--directory",
               "<path-to-repo>",
               "run",
               "arrakis_mcp_server.py"
           ]
       }
   }
   

API

The Arrakis MCP Server exposes the following MCP resources and tools:

Resources

• arrakis://vms - List all available VMs
• arrakis://vm/{vm_name} - Get information about a specific VM

Tools

• start_sandbox - Start a new VM sandbox
• restore_snapshot - Restore a VM from a snapshot
• snapshot - Create a snapshot of a VM
• run_command - Run a command in a VM
• upload_file - Upload a file to a VM
• download_file - Download a file from a VM
• destroy_vm - Destroy a specific VM
• destroy_all_vms - Destroy all VMs
• update_vm_state - Update the state of a VM (pause/stop)

License

This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.