SUSE Linux MCP Server

A Model Context Protocol (MCP) server that bridges AI assistants with the SUSE Linux ecosystem. Enables safe, reliable access to the openSUSE Wiki, OBS (Open Build Service), and SUSE repositories for AI-assisted system management.

Supports all SUSE variants: openSUSE Tumbleweed, Leap, MicroOS, Slowroll, SLES, SLED, and SLE Micro. Immutable variants use transactional-update automatically.

Resources (URI-based Access)

Documentation and Search

URI Scheme	Example	Returns
opensuse-wiki://	opensuse-wiki://Installation_guide	Markdown-formatted Wiki page

Package Information

URI Scheme	Example	Returns
suse-repo://	suse-repo://vim	Official repository package details
obs://*/spec	obs://vim/spec	OBS spec file with safety analysis
obs://*/info	obs://vim/info	OBS package metadata

System Packages (SUSE only)

URI Scheme	Example	Returns
zypper://installed	zypper://installed	Installed packages list
zypper://orphans	zypper://orphans	Orphaned packages
zypper://explicit	zypper://explicit	Explicitly installed packages
zypper://patterns	zypper://patterns	Zypper patterns
zypper://database/freshness	zypper://database/freshness	Package database sync status

System Monitoring and Logs

URI Scheme	Example	Returns
system://info	system://info	System information (kernel, memory, uptime)
system://disk	system://disk	Disk space usage statistics
system://services/failed	system://services/failed	Failed systemd services
system://logs/boot	system://logs/boot	Recent boot logs
system://health	system://health	System health check
zypper://log/recent	zypper://log/recent	Recent package transactions
zypper://log/failed	zypper://log/failed	Failed package transactions

News and Updates

URI Scheme	Example	Returns
opensuse-news://latest	opensuse-news://latest	Latest openSUSE news
opensuse-news://critical	opensuse-news://critical	Critical news requiring manual intervention
opensuse-news://since-update	opensuse-news://since-update	News since last system update

Configuration

URI Scheme	Example	Returns
config://zypper	config://zypper	Parsed zypper.conf configuration
config://rpm-macros	config://rpm-macros	Parsed RPM macros configuration
mirrors://active	mirrors://active	Currently configured repositories
mirrors://health	mirrors://health	Repository health status

Tools

Tool	Description
search_opensuse_wiki	Query openSUSE Wiki with ranked results
search_obs	Search OBS packages
get_official_package_info	Get official package details
check_updates_dry_run	Check for available updates
install_obs_package	Install OBS package with security checks
audit_obs_security	Security audit for OBS packages (spec analysis, full audit)
remove_packages	Remove packages (single or batch)
manage_orphans	List or remove orphaned packages
query_file_ownership	File-package ownership queries
verify_package_integrity	Check file integrity
manage_patterns	List and inspect zypper patterns
manage_install_reason	Manage install reasons (explicit/dependency)
get_system_info	System info (kernel, memory, uptime)
analyze_storage	Disk usage and cache statistics
diagnose_system	System diagnostics
fetch_news	Fetch openSUSE news
query_package_history	Query zypp transaction history
optimize_mirrors	Repository management (status, test, suggest, health)
analyze_zypper_conf	Parse zypper.conf settings
analyze_rpm_macros	Parse RPM macros configuration
check_database_freshness	Check package database sync status
run_system_health_check	Comprehensive system health check

Prompts

Prompt	Purpose
troubleshoot_issue	Diagnose system errors using openSUSE Wiki
audit_obs_package	Pre-installation security audit of OBS packages
analyze_dependencies	Dependency analysis and install order
safe_system_update	Safe update workflow with pre-flight checks
cleanup_system	System cleanup (orphans, cache, integrity)
package_investigation	Deep package research before installation
mirror_optimization	Test and configure fastest mirrors
system_health_check	Comprehensive system diagnostic

Installation

Prerequisites

• Python 3.11+
• uv (recommended) or pip

Quick Start

uv run suse-ops-server

Configuration

Add to your MCP client configuration (Claude, Cursor, or any STDIO-compatible client):

{
  "mcpServers": {
    "suse-linux": {
      "command": "uv",
      "args": ["run", "suse-ops-server"]
    }
  }
}

Container

podman build -f Containerfile .
podman run -i suse-mcp-server

License

This project is dual-licensed under your choice of:

• GPL-3.0-only - See LICENSE-GPL
• MIT License - See LICENSE-MIT