mcp-xcpng

A Model Context Protocol (MCP) server for XCP-ng / Xen Orchestra, providing AI assistants with full access to VM, host, storage, and snapshot management through the Xen Orchestra REST API.

Features

17 tools across four categories:

Virtual Machine Management

Host Management

Storage Management

Snapshot Management

Installation

git clone git@github.com:fredriksknese/mcp-xcpng.git
cd mcp-xcpng
npm install
npm run build

Configuration

The server is configured via environment variables:

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "xcpng": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-xcpng/dist/index.js"],
      "env": {
        "XO_HOST": "your-xen-orchestra.example.com",
        "XO_USERNAME": "admin@admin.net",
        "XO_PASSWORD": "your-password"
      }
    }
  }
}

Usage with Claude Code

claude mcp add xcpng -- node /absolute/path/to/mcp-xcpng/dist/index.js

Set the required environment variables before running, or configure them in your MCP settings.

Example Prompts

Once connected, you can ask your AI assistant things like:

• "Show me all running VMs on the cluster"
• "What is the memory usage on host xcp-01?"
• "Create a snapshot of vm-web-01 called 'pre-upgrade'"
• "List all storage repositories and their free space"
• "Stop the VM named 'test-server' cleanly"
• "Show me all snapshots for VM abc-1234"
• "What are the CPU stats for host xcp-node-02 over the last week?"
• "Delete the snapshot named 'old-backup' from VM prod-db"
• "List all VMs that are currently halted"
• "How much free space is left on the NFS storage repository?"

API

This server targets the Xen Orchestra REST API (/rest/v0/), which is available in Xen Orchestra Community Edition (XO-CE) and the commercial Xen Orchestra appliance (XOA).

Authentication uses the session cookie mechanism: a POST /rest/v0/session with credentials returns a cookie that is used for all subsequent requests.

Note: The Xen API (XAPI) XML-RPC interface is available directly on XCP-ng hosts at https://{host}/RPC2 and uses Session.login_with_password for authentication. This server targets XO as the management layer instead, which provides a unified API across all hosts in a pool.

Development

npm run dev      # Run with tsx (auto-reloads)
npm run build    # Compile TypeScript to dist/
npm start        # Run compiled output

Architecture

src/
├── index.ts              # Entry point — creates MCP server + STDIO transport
├── xcpng-client.ts       # HTTP client wrapping the Xen Orchestra REST API
└── tools/
    ├── vms.ts            # VM lifecycle management (7 tools)
    ├── hosts.ts          # Host info and statistics (3 tools)
    ├── storage.ts        # Storage repositories and VDIs (3 tools)
    └── snapshots.ts      # Snapshot CRUD and revert (4 tools)

Requirements

• Node.js 18+
• Xen Orchestra (XOA or XO-CE) with REST API enabled
• XCP-ng hypervisor hosts managed by Xen Orchestra

License

SEE LICENSE IN LICENSE