English Français العربية

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

Official registry Other

MCP server for read-only Linux system administration, diagnostics, and troubleshooting

Source code Documentation

What can you do with io.github.rhel-lightspeed/linux-mcp-server?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package linux-mcp-server
Claude Code 
claude mcp add linux-mcp-server -e 'LINUX_MCP_USER=<LINUX_MCP_USER>' -e 'LINUX_MCP_SSH_KEY_PATH=<LINUX_MCP_SSH_KEY_PATH>' -e 'LINUX_MCP_KEY_PASSPHRASE=<your linux_mcp_key_passphrase>' -e 'LINUX_MCP_SEARCH_FOR_SSH_KEY=<LINUX_MCP_SEARCH_FOR_SSH_KEY>' -e 'LINUX_MCP_COMMAND_TIMEOUT=<LINUX_MCP_COMMAND_TIMEOUT>' -e 'LINUX_MCP_VERIFY_HOST_KEYS=<LINUX_MCP_VERIFY_HOST_KEYS>' -e 'LINUX_MCP_KNOWN_HOSTS_PATH=<LINUX_MCP_KNOWN_HOSTS_PATH>' -e 'LINUX_MCP_ALLOWED_LOG_PATHS=<LINUX_MCP_ALLOWED_LOG_PATHS>' -e 'LINUX_MCP_LOG_DIR=<LINUX_MCP_LOG_DIR>' -e 'LINUX_MCP_LOG_LEVEL=<LINUX_MCP_LOG_LEVEL>' -e 'LINUX_MCP_LOG_RETENTION_DAYS=<LINUX_MCP_LOG_RETENTION_DAYS>' -- uvx linux-mcp-server==1.4.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "linux-mcp-server": {
            "command": "uvx",
            "args": [
                "linux-mcp-server==1.4.0"
            ],
            "env": {
                "LINUX_MCP_USER": "<LINUX_MCP_USER>",
                "LINUX_MCP_SSH_KEY_PATH": "<LINUX_MCP_SSH_KEY_PATH>",
                "LINUX_MCP_KEY_PASSPHRASE": "<your linux_mcp_key_passphrase>",
                "LINUX_MCP_SEARCH_FOR_SSH_KEY": "<LINUX_MCP_SEARCH_FOR_SSH_KEY>",
                "LINUX_MCP_COMMAND_TIMEOUT": "<LINUX_MCP_COMMAND_TIMEOUT>",
                "LINUX_MCP_VERIFY_HOST_KEYS": "<LINUX_MCP_VERIFY_HOST_KEYS>",
                "LINUX_MCP_KNOWN_HOSTS_PATH": "<LINUX_MCP_KNOWN_HOSTS_PATH>",
                "LINUX_MCP_ALLOWED_LOG_PATHS": "<LINUX_MCP_ALLOWED_LOG_PATHS>",
                "LINUX_MCP_LOG_DIR": "<LINUX_MCP_LOG_DIR>",
                "LINUX_MCP_LOG_LEVEL": "<LINUX_MCP_LOG_LEVEL>",
                "LINUX_MCP_LOG_RETENTION_DAYS": "<LINUX_MCP_LOG_RETENTION_DAYS>"
            }
        }
    }
}

Environment variables

  • 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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

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 [documentation].

[documentation]: https://rhel-lightspeed.github.io/linux-mcp-server/

Frequently asked questions

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

MCP server for read-only Linux system administration, diagnostics, and troubleshooting

How do I install io.github.rhel-lightspeed/linux-mcp-server?

It runs on your machine. In Claude Code: claude mcp add linux-mcp-server -e 'LINUX_MCP_USER=<LINUX_MCP_USER>' -e 'LINUX_MCP_SSH_KEY_PATH=<LINUX_MCP_SSH_KEY_PATH>' -e 'LINUX_MCP_KEY_PASSPHRASE=<your linux_mcp_key_passphrase>' -e 'LINUX_MCP_SEARCH_FOR_SSH_KEY=<LINUX_MCP_SEARCH_FOR_SSH_KEY>' -e 'LINUX_MCP_COMMAND_TIMEOUT=<LINUX_MCP_COMMAND_TIMEOUT>' -e 'LINUX_MCP_VERIFY_HOST_KEYS=<LINUX_MCP_VERIFY_HOST_KEYS>' -e 'LINUX_MCP_KNOWN_HOSTS_PATH=<LINUX_MCP_KNOWN_HOSTS_PATH>' -e 'LINUX_MCP_ALLOWED_LOG_PATHS=<LINUX_MCP_ALLOWED_LOG_PATHS>' -e 'LINUX_MCP_LOG_DIR=<LINUX_MCP_LOG_DIR>' -e 'LINUX_MCP_LOG_LEVEL=<LINUX_MCP_LOG_LEVEL>' -e 'LINUX_MCP_LOG_RETENTION_DAYS=<LINUX_MCP_LOG_RETENTION_DAYS>' -- uvx linux-mcp-server==1.4.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.rhel-lightspeed/linux-mcp-server need an API key?

Yes. It expects LINUX_MCP_KEY_PASSPHRASE, which you set in its configuration.

Is io.github.rhel-lightspeed/linux-mcp-server open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.rhel-lightspeed/linux-mcp-server?

It is published by rhel-lightspeed. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.