Back to Home
uyuni-project icon

mcp-server-uyuni

Verified Safe

by uyuni-project

Overview

The Uyuni MCP Server enables AI agents or MCP-compliant clients to securely interact with and manage Linux infrastructure using natural language via the Uyuni configuration and infrastructure management solution.

Installation

Run Command
docker run -i --rm --env-file /path/to/uyuni-config.env ghcr.io/uyuni-project/mcp-server-uyuni:latest

Environment Variables

  • UYUNI_SERVER
  • UYUNI_USER
  • UYUNI_PASS
  • UYUNI_MCP_HOST
  • UYUNI_MCP_PORT
  • UYUNI_AUTH_SERVER
  • UYUNI_MCP_SSL_VERIFY
  • UYUNI_MCP_WRITE_TOOLS_ENABLED
  • UYUNI_MCP_TRANSPORT
  • UYUNI_MCP_LOG_FILE_PATH
  • UYUNI_MCP_LOG_LEVEL
  • UYUNI_SSH_PRIV_KEY
  • UYUNI_SSH_PRIV_KEY_PASS

Security Notes

The server implements strong security practices including opt-in write capabilities via environment variables (`UYUNI_MCP_WRITE_TOOLS_ENABLED`) and a custom `@write_tool` decorator, detailed API error handling, and a confirmation flow for potentially destructive actions. It explicitly warns about the security risks of running with `http` transport without OAuth 2.0 authentication (`UYUNI_AUTH_SERVER`) and the trust-based nature of the `confirm` parameter (recommending elicitation as a more robust alternative). Sensitive credentials (Uyuni API user/pass, SSH private key) are loaded from environment variables. The SSH private key for the `add_system` tool is passed to the main Uyuni server for connection, not used directly by the MCP server itself, which helps mitigate direct exposure risk. Potential security risks primarily stem from misconfiguration (e.g., enabling write tools or HTTP transport without proper authentication in an untrusted network environment) rather than inherent flaws in the server's security design.

Similar Servers

Stats

Interest Score34
Security Score8
Cost ClassMedium
Avg Tokens500
Stars9
Forks4
Last Update2026-01-07

Tags

UyuniLLMAIInfrastructure ManagementAutomation