abshkbh/arrakis-mcp-server

11 stars 5 forks Quality 46 Trend 18AGPL-3.0

MCP server for https://github.com/abshkbh/arrakis

Overview

A Model Context Protocol (MCP) server that exposes Arrakis VM sandbox functionality to Large Language Models. 2. Configure your LLM tool to use the Arrakis MCP server by adding the following to your MCP configuration: The Arrakis MCP Server exposes the following MCP resources and tools: - arrakis://vms - List all available VMs - arrakis://vm/{vm_name} - Get information about a specific VM - 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) This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.

README

Arrakis MCP Server

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

Setup

Clone this repository:

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

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

"mcpServers": {
    "arrakis": {
        "command": "",
        "args": [
            "--directory",
            "",
            "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.

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

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