Arrakis MCP Server
About
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.
Details
- License
- AGPL-3.0
Explore
- 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.
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"
]
}
}
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)
- 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)
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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
