Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Xen Orchestra Server

FreeNot checked

Enables management of Xen Orchestra (XOA) via its REST API, including listing VMs, backup jobs, logs, and repositories.

GitHubEmbed

About

Enables management of Xen Orchestra (XOA) via its REST API, including listing VMs, backup jobs, logs, and repositories.

README

��# Xen Orchestra MCP Server =���� ![](icon.png) A Model Context Protocol (MCP) server written in =� �Python to manage =����Xen Orchestra (XOA) via its REST API. The project is currently under heavy development. Run the Server on your own risk. ## =�-� Purpose This MCP server provides tools to manage and retrieve information from Xen Orchestra using the REST API. ## =�)� Features - get_docs - Get the swagger docs from the Xen Orchestra API. - list_vms - List VMs with their fields based on filters and limit. - create_vm (under construction <����) - Create a VM by providing a JSON payload. - delete_vm (under construction <����) - Delete a VM given its UUID or href. - modify_vm (under construction <����) - Modify VM properties name_label and/or name_description. - **list_backup_jobs** - List backup jobs with their fields based on filters and limit. - **get_backup_job_details** - List backup job details based on the backup job id. - **list_backup_logs** - List backup logs with their fields based on filters and limit. - **get_backup_log_details** - List backup logs details based on the backup log id. - **list_backup_repositories** - List backup repositories with their fields based on filters and limit. - **get_backup_repository_details** - List backup repository details based on the backup repository id. ## �&� Prerequisites - =� � Docker Desktop with MCP Toolkit enabled (the docker mcp CLI). - =���� Xen Orchestra instance reachable from the host running the container. - =�� Xen Orchestra authentication token (create it in the XOA UI under your user, check out the [offical documentation](https://docs.xcp-ng.org/management/manage-at-scale/xo-api/) if you need help). Checkout the [installation instructions](Installation.md) for detailed information on how to setup the Docker MCP Server and your MCP client. ## =���� Environment variables - XOA_URL : Base URL of your Xen Orchestra instance (e.g. https://xoa.example.lan) **no trailing slash**. - XOA_TOKEN : The authentication token created in Xen Orchestra UI. - CERT_VERIFY (optional, defaults to True): Whether the SSL certificate of your Xen Orchestra webserver should be checked or not. You can also provide a path to your certificate in the containers filesystem: /path/to/your/cert.pem **Add the cert as Volume for this to work** ## =��� Example Prompts 1. List all running vms 2. List all stopped VMs with their name and tags 3. Tell me what backup jobs i have configured 4. List all of my metadata backups 5. Provide all details for my full backups 6. List the 5 last failed backups 7. List the logs for the 10 last full backups 8. List log details for the last failed backup --> List more detailed logs for this backup 9. List all backup repositories --> List details for the <your-repository-name> backup repository ## =��� Architecture Client �! Docker MCP Gateway �! Xen Orchestra MCP Server (this project) �! Xen Orchestra REST API Secrets: XOA_TOKEN should be provided through Docker Desktop secrets or an .env file. ## =�,� Development / Local testing Set environment variables locally for testing: bash export XOA_URL="https://xoa.example.lan" export XOA_TOKEN="your-token-here" python main.py

from github.com/Videothek/xo-mcp-server

Installing Xen Orchestra Server

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/Videothek/xo-mcp-server

FAQ

Is Xen Orchestra Server MCP free?

Yes, Xen Orchestra Server MCP is free — one-click install via Unyly at no cost.

Does Xen Orchestra Server need an API key?

No, Xen Orchestra Server runs without API keys or environment variables.

Is Xen Orchestra Server hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Xen Orchestra Server in Claude Desktop, Claude Code or Cursor?

Open Xen Orchestra Server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Xen Orchestra Server with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs