linux-mcp-server

Tools to allow LLM clients to interact with Linux systems remotely

Install

uvx linux-mcp-server

LINUX_MCP_USERoptional — Default username for SSH connections
LINUX_MCP_SSH_KEY_PATHoptional — Path to SSH private key
LINUX_MCP_KEY_PASSPHRASEoptional · secret — Passphrase for encrypted SSH key
LINUX_MCP_SEARCH_FOR_SSH_KEYoptional — Auto-discover keys in `~/.ssh`
LINUX_MCP_COMMAND_TIMEOUToptional — SSH command timeout in seconds (default: 30)
LINUX_MCP_VERIFY_HOST_KEYSoptional — Verify remote host identity via known_hosts
LINUX_MCP_KNOWN_HOSTS_PATHoptional — Custom path to known_hosts file
LINUX_MCP_ALLOWED_LOG_PATHSoptional — Comma-separated allowlist of log files
LINUX_MCP_LOG_DIRoptional — Server log directory
LINUX_MCP_LOG_LEVELoptional — Log verbosity (DEBUG, INFO, WARNING)
LINUX_MCP_LOG_RETENTION_DAYSoptional — Days to keep log files

README.md

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

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

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