suse-mcp

suse-mcp

MCP server that bridges AI assistants with the SUSE Linux ecosystem, enabling safe access to openSUSE Wiki, OBS, and repositories for system management.

Category
Visit Server

README

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:

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured