MCP Server

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

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

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

Repository Registry

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

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

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

Claude Desktop

~/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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "linux-mcp-server": {
      "type": "stdio",
      "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>"
      }
    }
  }
}

Claude Code

claude mcp add linux-mcp-server --env LINUX_MCP_USER=<YOUR_LINUX_MCP_USER> --env LINUX_MCP_SSH_KEY_PATH=<YOUR_LINUX_MCP_SSH_KEY_PATH> --env LINUX_MCP_KEY_PASSPHRASE=<YOUR_LINUX_MCP_KEY_PASSPHRASE> --env LINUX_MCP_SEARCH_FOR_SSH_KEY=<YOUR_LINUX_MCP_SEARCH_FOR_SSH_KEY> --env LINUX_MCP_COMMAND_TIMEOUT=<YOUR_LINUX_MCP_COMMAND_TIMEOUT> --env LINUX_MCP_VERIFY_HOST_KEYS=<YOUR_LINUX_MCP_VERIFY_HOST_KEYS> --env LINUX_MCP_KNOWN_HOSTS_PATH=<YOUR_LINUX_MCP_KNOWN_HOSTS_PATH> --env LINUX_MCP_ALLOWED_LOG_PATHS=<YOUR_LINUX_MCP_ALLOWED_LOG_PATHS> --env LINUX_MCP_LOG_DIR=<YOUR_LINUX_MCP_LOG_DIR> --env LINUX_MCP_LOG_LEVEL=<YOUR_LINUX_MCP_LOG_LEVEL> --env LINUX_MCP_LOG_RETENTION_DAYS=<YOUR_LINUX_MCP_LOG_RETENTION_DAYS> -- uvx linux-mcp-server