What does the uyuni mcp server do?

It connects Uyuni to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Uyuni directly.

How do I install the uyuni mcp server?

Run it through your MCP client's configuration using `docker run -i --rm ghcr.io/uyuni-project/mcp-server-uyuni`. Add the server block to Claude Desktop's config file (or use `claude mcp add` for Claude Code), restart the client, and the tools appear automatically. Full snippets are on this page.

What credentials does it need?

It reads `UYUNI_SSH_PRIV_KEY`, `UYUNI_MCP_HOST`, `UYUNI_MCP_PUBLIC_URL`, `UYUNI_MCP_LOG_FILE_PATH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

Uyuni MCP Server — Features, Setup & Tools

Name: Uyuni MCP Server
Author: uyuni-project

What is the Uyuni MCP server?

Uyuni mcp server connects Uyuni to AI assistants that speak the Model Context Protocol. The Uyuni MCP Server is a Model Context Protocol (MCP) server implementation that bridges the gap between Large Language Models (LLMs) and the Uyuni configuration and infrastructure management solution.

What Uyuni does

The Uyuni MCP Server is a Model Context Protocol (MCP) server implementation that bridges the gap between Large Language Models (LLMs) and the Uyuni configuration and infrastructure management solution.

Installing the uyuni mcp server

The server is distributed via a container image as ghcr.io/uyuni-project/mcp-server-uyuni, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.

Configuration

Before the server will start you need to supply 4 environment variables: UYUNI_SSH_PRIV_KEY, UYUNI_MCP_HOST, UYUNI_MCP_PUBLIC_URL, UYUNI_MCP_LOG_FILE_PATH. Keep credentials in your client's env block or a secrets manager rather than committing them.

Where it fits

Cloud and DevOps servers put infrastructure on speaking terms with your assistant, so "why is this broken?" is answered from real state rather than a generic checklist. Uyuni sits in that group. Worth comparing against the other cloud devops servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.

Practical notes

This is a hosted server — you point your client at an endpoint rather than running a local process, so there is nothing to keep updated on your machine.
It will not start until its required credentials are present, so set those before wondering why the tools never appear.
Maintained by uyuni-project, written in Python.
MCP clients ask for confirmation before each tool call by default. Keep that on while you learn what the uyuni mcp server actually does with your data.
Every entry in this directory is reviewed by hand before it goes live, and details are checked against the project's own documentation.

How to install the Uyuni MCP server

{
  "mcpServers": {
    "server-uyuni": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/uyuni-project/mcp-server-uyuni"],
      "env": {
        "UYUNI_SSH_PRIV_KEY": "your-value",
        "UYUNI_MCP_HOST": "your-value",
        "UYUNI_MCP_PUBLIC_URL": "your-value",
        "UYUNI_MCP_LOG_FILE_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
UYUNI_SSH_PRIV_KEY	Credential the server authenticates with.	Yes
UYUNI_MCP_HOST	Endpoint or connection string the server talks to.	Optional
UYUNI_MCP_PUBLIC_URL	Endpoint or connection string the server talks to.	Yes
UYUNI_MCP_LOG_FILE_PATH	Filesystem location the server is allowed to use.	Optional

Uyuni MCP Server

What is the Uyuni MCP server?

What Uyuni does

Installing the uyuni mcp server

Configuration

Where it fits

Practical notes

How to install the Uyuni MCP server

Configuration

Frequently asked questions

Alternatives to the Uyuni MCP server

Supabase

n8n

AWS

Browserbase

Cloudflare

Grafana