Description

SUSE Multi-Linux Manager MCP Server

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

This project allows AI agents or MCP-compliant clients (such as Gemini CLI or Claude Desktop) to securely interact with your SUSE Multi-Linux Manager Server. The MCP server enables users to manage their Linux infrastructure using natural language. Instead of navigating the web UI or writing complex API scripts, you can simply ask your AI assistant to perform tasks like getting system details, checking for updates, or scheduling maintenance.

Key Capabilities This server exposes a suite of tools that allow LLMs to:

• Inspect Infrastructure: Retrieve lists of active systems and view system information.
• Manage Updates: Identify systems with pending security updates or CVEs and schedule patch applications.
• Execute Actions: Schedule patches, system updates and reboots.

It is designed to be run as a container remotely (HTTP) or locally (stdio), offering a streamlined way to integrate AI-driven automation into your system administration workflows.

How to use this container with Gemini CLI

Install

For downloading and installing Gemini CLI, run Zypper if you are using openSUSE Linux, or review and use any of the recommended installation options:

• Zypper: zypper install gemini-cli
• NPM: npm install -g @google/gemini-cli

Configure

Configuration is mainly done in ~/.gemini/settings.json. There is different ways to do the authentication, especially:

• oauth-personal: mainly for personal accounts, redirects to the browser for login
• gemini-api-key: expects your API key defined as an environment variable (GEMINI_API_KEY="...")

API keys can generally be downloaded from here. The examples here are using oauth-personal, you can change it to use your gemini-api-key in case you have a key in your ~/.gemini/.env file.

This is how to configure it for an already running instance of the MCP server using HTTP (this is ~/.gemini/settings.json):

{
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  },
  "mcpServers": {
    "uyuni": {
      "url": "http://...",
      "type": "http"
    }
  }
}

Alternatively it can run locally against your SUSE Multi-Linux Manager server (using stdio mode), which requires podman to be installed on your system (again ~/.gemini/settings.json):

{
  "security": {
    "auth": {
      "selectedType": "oauth-personal"
    }
  },
  "mcpServers": {
    "uyuni": {
      "command": "podman",
      "args": ["run", "-i", "--rm",
        "-e", "UYUNI_SERVER=...",
        "-e", "UYUNI_USER=...",
        "-e", "UYUNI_PASS=...",
        // Disable SSL cert validation
        // "-e", "UYUNI_MCP_SSL_VERIFY=false",
        // Enable write tools
        // "-e", "UYUNI_MCP_WRITE_TOOLS_ENABLED=true",
        "registry.suse.com/suse/agentic/mcp/multi-linux-manager:latest"
      ]
    }
  }
}

For all the configuration options, please refer to the main README file. Environment variables given to podman via args can also be defined in ~/.gemini/.env.

Run

Run it in your favorite terminal (it's a CLI):

gemini

License

SPDX-License-Identifier: Apache-2.0

This project is licensed under the Apache License, Version 2.0. See the LICENSE file for details.

The container itself contains various software components under various open source licenses listed in the associated Software Bill of Materials (SBOM).

This image is a tech preview. Do not use it for production.