PluginBench
MCP Server
Active
Apache-2.0

io.github.rhel-lightspeed/linux-mcp-server MCP Server

io.github.rhel-lightspeed/linux-mcp-server

Read-only Linux system diagnostics and troubleshooting via MCP with remote SSH support

RepositoryRegistry

What is the io.github.rhel-lightspeed/linux-mcp-server MCP server?

The Linux MCP Server is a Model Context Protocol server for read-only Linux system administration, diagnostics, and troubleshooting on RHEL-based systems. It enables safe remote system inspection via SSH with multi-host management capabilities and comprehensive diagnostic tools.

This server provides AI agents with safe, read-only access to Linux system information and diagnostics. It's designed for RHEL systems and supports remote SSH execution, making it useful for troubleshooting, monitoring, and analyzing system state across multiple hosts without risk of accidental modifications.

How to install io.github.rhel-lightspeed/linux-mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • LINUX_MCP_USER

    Default username for SSH connections

  • LINUX_MCP_SSH_KEY_PATH

    Path to SSH private key

  • LINUX_MCP_KEY_PASSPHRASE
    secret

    Passphrase for encrypted SSH key

  • LINUX_MCP_SEARCH_FOR_SSH_KEY

    Auto-discover keys in `~/.ssh`

  • LINUX_MCP_COMMAND_TIMEOUT

    SSH command timeout in seconds (default: 30)

  • LINUX_MCP_VERIFY_HOST_KEYS

    Verify remote host identity via known_hosts

  • LINUX_MCP_KNOWN_HOSTS_PATH

    Custom path to known_hosts file

  • LINUX_MCP_ALLOWED_LOG_PATHS

    Comma-separated allowlist of log files

  • LINUX_MCP_LOG_DIR

    Server log directory

  • LINUX_MCP_LOG_LEVEL

    Log verbosity (DEBUG, INFO, WARNING)

  • LINUX_MCP_LOG_RETENTION_DAYS

    Days to keep log files

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "linux-mcp-server": {
      "command": "uvx",
      "args": [
        "linux-mcp-server"
      ],
      "env": {
        "LINUX_MCP_USER": "<YOUR_LINUX_MCP_USER>",
        "LINUX_MCP_SSH_KEY_PATH": "<YOUR_LINUX_MCP_SSH_KEY_PATH>",
        "LINUX_MCP_KEY_PASSPHRASE": "<YOUR_LINUX_MCP_KEY_PASSPHRASE>",
        "LINUX_MCP_SEARCH_FOR_SSH_KEY": "<YOUR_LINUX_MCP_SEARCH_FOR_SSH_KEY>",
        "LINUX_MCP_COMMAND_TIMEOUT": "<YOUR_LINUX_MCP_COMMAND_TIMEOUT>",
        "LINUX_MCP_VERIFY_HOST_KEYS": "<YOUR_LINUX_MCP_VERIFY_HOST_KEYS>",
        "LINUX_MCP_KNOWN_HOSTS_PATH": "<YOUR_LINUX_MCP_KNOWN_HOSTS_PATH>",
        "LINUX_MCP_ALLOWED_LOG_PATHS": "<YOUR_LINUX_MCP_ALLOWED_LOG_PATHS>",
        "LINUX_MCP_LOG_DIR": "<YOUR_LINUX_MCP_LOG_DIR>",
        "LINUX_MCP_LOG_LEVEL": "<YOUR_LINUX_MCP_LOG_LEVEL>",
        "LINUX_MCP_LOG_RETENTION_DAYS": "<YOUR_LINUX_MCP_LOG_RETENTION_DAYS>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • System Information — Retrieve system details and configuration information
  • Service Management — Query systemd services and their status
  • Process Inspection — Examine running processes and their details
  • Log Access — Read system logs with configurable access control
  • Network Diagnostics — Inspect network configuration and connectivity
  • Storage Analysis — Query disk usage and storage information
  • Remote SSH Execution — Execute read-only commands on remote systems via SSH with key-based authentication

Use cases

  • Diagnose system issues and troubleshoot problems on RHEL servers
  • Monitor service status and process behavior across multiple hosts
  • Analyze logs and system events for root cause analysis
  • Inspect network configuration and connectivity issues
  • Check disk usage and storage capacity on remote systems

io.github.rhel-lightspeed/linux-mcp-server MCP server FAQ

What is the Linux MCP Server?

It's an MCP server that gives AI agents read-only access to Linux system diagnostics and administration tools, optimized for RHEL-based systems with remote SSH support.

Is it safe to use?

Yes, all operations are strictly read-only, so there's no risk of accidental system modifications.

How do I install it?

Install via pip: `pip install linux-mcp-server`. See the official installation guide for uv and container-based deployments.

Does it support remote systems?

Yes, it supports remote SSH execution with key-based authentication and can manage multiple hosts in the same session.

Which Linux distributions does it support?

It's optimized for Red Hat Enterprise Linux (RHEL) systems and uses systemd for service management.

Can I control which logs are accessible?

Yes, log file access is configurable via environment variables for security and privacy control.

README (reference)

Source of truth, from the repository.

<!-- mcp-name: io.github.rhel-lightspeed/linux-mcp-server -->

CI Coverage PyPI Docs

Linux MCP Server

A Model Context Protocol (MCP) server for read-only Linux system administration, diagnostics, and troubleshooting on RHEL-based systems.

Features

  • Read-Only Operations: All tools are strictly read-only for safe diagnostics
  • Remote SSH Execution: Execute commands on remote systems via SSH with key-based authentication
  • Multi-Host Management: Connect to different remote hosts in the same session
  • Comprehensive Diagnostics: System info, services, processes, logs, network, and storage
  • Configurable Log Access: Control which log files can be accessed via environment variables
  • RHEL/systemd Focused: Optimized for Red Hat Enterprise Linux systems

Installation and Usage

For detailed instructions on setting up and using the Linux MCP Server, please refer to our official documentation:

  • Installation Guide: Detailed steps for pip, uv, and container-based deployments.
  • Usage Guide: Information on running the server, configuring LLM clients, and troubleshooting.
  • Cheatsheet: A reference for what prompts to use to invoke various tools.

Related MCP servers

AN

Antigravity Headless Bridge

Call Google's Antigravity CLI (agy) headlessly from non-TTY contexts (subprocess, MCP, CI).

ETEtapa — Cycling Coach MCP logo

Etapa — Cycling Coach MCP

AI cycling coach — training plans and beginner guidance via the Etapa API.

View repository →
RURuleDrift logo

RuleDrift

Active

Test whether AI agents retain critical instructions as conversations grow.

1
TypeScript
MIT
View repository →
VOVolante logo

Volante

Active

Routes to the best predicted fit from configured metadata/evidence after hard-capability filtering.

0
Python
MIT
View repository →
IOio.github.ribhav-jain/docsonar logo

io.github.ribhav-jain/docsonar

Active

Local document search over your folders: hybrid keyword+semantic, fully offline, read-only

0
Python
MIT
View repository →
IOio.github.ricardo-hdrn/mcp-await logo

io.github.ricardo-hdrn/mcp-await

Maintained

Condition watcher for AI assistants — wait for ports, files, URLs, processes, and more

1
Rust
MIT
View repository →