MCPgee
MCPgee
MCPgeeMCPgee

Uyuni

v1.0.0•Cloud Services•stable

Enabling LLMs to interact with Uyuni

uyunimcpai-integration
Share:
12
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Uyuni?

Uyuni is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enabling llms to interact with uyuni

Enabling LLMs to interact with Uyuni

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enabling LLMs to interact with Uyuni

Use Cases

Interact with Uyuni system management platform via AI.
Automate Uyuni infrastructure operations and monitoring.
uyuni-project

Maintainer

LicenseApache-2.0
Languagepython
Versionv1.0.0
UpdatedMay 18, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx uyuni

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Uyuni

The Uyuni MCP Server enables LLMs and AI agents to interact with the Uyuni open-source IT infrastructure management platform. It exposes tools for inspecting systems, managing update schedules, scheduling reboots, handling CVE patching, managing system groups, and performing lifecycle operations — all accessible in read-only mode by default with opt-in write access.

Prerequisites

  • A running Uyuni server instance accessible over the network
  • Docker (for container-based deployment) or Python with uv (for local development)
  • Uyuni credentials (username/password) or an OAuth 2.0 identity provider for HTTP mode
  • An MCP-compatible AI client such as Claude Desktop or Claude Code
1

Create an environment file with your Uyuni credentials

Create a .env file with your Uyuni server address and credentials. This file is passed to the Docker container at runtime to avoid embedding secrets in the config.

# uyuni-config.env
UYUNI_SERVER=192.168.1.124:8443
UYUNI_USER=admin
UYUNI_PASS=yourpassword
UYUNI_MCP_SSL_VERIFY=true
UYUNI_MCP_WRITE_TOOLS_ENABLED=false
2

Pull the container image

Pull the pre-built Uyuni MCP Server image from the GitHub Container Registry. Replace VERSION with the desired release tag.

docker pull ghcr.io/uyuni-project/mcp-server-uyuni:latest
3

Test the server locally

Run the container in HTTP mode on port 8080 to verify connectivity to your Uyuni instance before connecting an AI client.

docker run --env-file /path/to/uyuni-config.env \
  -e UYUNI_MCP_TRANSPORT=http \
  -p 8080:8080 \
  ghcr.io/uyuni-project/mcp-server-uyuni:latest
4

Enable write tools when ready (optional)

By default the server is read-only. To allow state-changing operations (schedule updates, reboot systems, manage groups), set UYUNI_MCP_WRITE_TOOLS_ENABLED=true in your env file.

# Add to uyuni-config.env
UYUNI_MCP_WRITE_TOOLS_ENABLED=true
5

Add the server to your MCP client config

Register the Uyuni MCP server with Claude Desktop or Claude Code using the Docker stdio transport for local use.

Uyuni Examples

Client configuration

Claude Desktop configuration using Docker to run the Uyuni MCP server in stdio mode with credentials from an env file.

{
  "mcpServers": {
    "uyuni": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--env-file", "/path/to/uyuni-config.env",
        "ghcr.io/uyuni-project/mcp-server-uyuni:latest"
      ]
    }
  }
}

Prompts to try

Use these prompts to manage your Uyuni infrastructure through the AI agent.

- "List all systems registered in Uyuni and show their patch status"
- "Which systems need a reboot after recent updates?"
- "Show me all systems affected by CVE-2024-1234"
- "Summarize pending updates across the entire fleet"
- "List all system groups and their member counts"

Troubleshooting Uyuni

SSL verification errors when connecting to Uyuni

If your Uyuni server uses a self-signed certificate, set UYUNI_MCP_SSL_VERIFY=false in your env file. For production, import your Uyuni server's CA certificate into the container's trust store instead of disabling verification.

Write tools are not available even after setting UYUNI_MCP_WRITE_TOOLS_ENABLED=true

Restart the Docker container after modifying the env file — environment variables are only read at startup. Verify the env file path is correct in the --env-file argument and that the variable name is spelled exactly as UYUNI_MCP_WRITE_TOOLS_ENABLED.

Authentication fails with username/password

Test credentials by logging into the Uyuni web UI with the same username and password. If using HTTP transport with OAuth, ensure UYUNI_AUTH_SERVER is set to a reachable OAuth 2.0 provider. For stdio mode, username/password authentication should work without an OAuth server.

Frequently Asked Questions about Uyuni

What is Uyuni?

Uyuni is a Model Context Protocol (MCP) server that enabling llms to interact with uyuni It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Uyuni?

Follow the installation instructions on the Uyuni GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Uyuni?

Uyuni works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Uyuni free to use?

Yes, Uyuni is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Uyuni Alternatives — Similar Cloud Services Servers

Looking for alternatives to Uyuni? Here are other popular cloud services servers you can use with Claude, Cursor, and VS Code.

Open WebUI

★ 138.2k

User-friendly AI Interface (Supports Ollama, OpenAI API, ...)

Anything LLM

★ 60.4k

The all-in-one AI productivity accelerator. On device and privacy first with no annoying setup or configuration.

LocalAI

★ 46.4k

LocalAI is the open-source AI engine. Run any model - LLMs, vision, voice, image, video - on any hardware. No GPU required.

Nacos

★ 33.0k

an easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.

Xiaozhi ESP32

★ 26.7k

本项目为xiaozhi-esp32提供后端服务，帮助您快速搭建ESP32设备控制服务器。Backend service for xiaozhi-esp32, helps you quickly build an ESP32 device control server.

Gateway

★ 11.8k

A blazing fast AI Gateway with integrated guardrails. Route to 1,600+ LLMs, 50+ AI Guardrails with 1 fast & friendly API.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Cloud ServicesBrowse All Servers

Quick Config Preview

{ "mcpServers": { "uyuni": { "command": "npx", "args": ["-y", "uyuni"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Uyuni?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides