Test SSH connectivity to the target host.

Verifies the connection is alive and returns basic server identity.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Connection status and remote hostname.

List all SSH hosts configured in SSH_HOSTS_JSON.

Returns: Table of configured host names and their connection details.

Close the SSH connection to a host.

The connection will be re-established automatically on the next tool call.

Args: host_name: Named host to disconnect; disconnects default host if omitted.

Returns: Confirmation message.

Close all active SSH connections.

Returns: Confirmation message.

Check disk health using SMART data and filesystem errors.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Disk health status and any detected errors.

Diagnose high CPU/memory load and identify resource hogs.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Top resource consumers and system load details.

Test outbound network connectivity from the remote server.

Args: target: IP or hostname to ping/reach (default "8.8.8.8"). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Ping results and DNS resolution status.

Run a basic security audit of the remote server.

Checks for: failed login attempts, listening ports, SUID files, world-writable directories, and recent auth log entries.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Security audit report.

Tail the end of a remote log file.

Args: path: Absolute path to the log file (e.g., "/var/log/nginx/error.log"). lines: Number of lines to retrieve from the end (default 50). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Last N lines of the log file.

Analyze a log file for error patterns and summarize findings.

Searches for ERROR, WARN, CRITICAL, Exception, and similar keywords.

Args: path: Absolute path to the log file. host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Error/warning summary with counts and recent examples.

Execute a shell command on the remote SSH server.

Runs any shell command and returns stdout + stderr. Suitable for one-off commands, diagnostics, log tailing, service control, etc.

Args: command: The shell command to execute (e.g., "df -h", "systemctl status nginx"). timeout: Maximum seconds to wait for the command to finish (default 60). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Command output (stdout), or combined stdout/stderr on error.

Execute a multi-line shell script on the remote SSH server.

Uploads the script via stdin and runs it with the specified shell. Useful for multi-step automation, configuration changes, or complex checks.

Args: script: The full script content (multi-line bash/sh/python script). shell: Shell interpreter to use: "bash", "sh", "python3", etc. (default "bash"). timeout: Maximum seconds to wait (default 120). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Script output or error details.

Read the content of a remote file.

Args: path: Absolute path to the file (e.g., "/etc/nginx/nginx.conf"). max_lines: Maximum number of lines to return (default 200, 0 = unlimited). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: File content as text.

Write content to a remote file (overwrites existing content).

Creates parent directories if they do not exist.

Args: path: Absolute path to the destination file. content: Text content to write. host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Success message or error details.

Append content to a remote file.

Args: path: Absolute path to the file. content: Text content to append. host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Success message or error details.

List files and directories at a remote path.

Args: path: Directory path to list (default "/"). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Directory listing with permissions, size, and modification time.

Delete a file or directory on the remote server.

Args: path: Absolute path to delete. recursive: If True, delete directory and all its contents (use with caution). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Success message or error details.

Search for files by name pattern in a remote directory tree.

Args: path: Root directory to search from. pattern: File name pattern (e.g., "*.log", "nginx.conf"). file_type: Filter by type: "file" (f), "dir" (d), or "any" (default). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: List of matching file paths.

Search for a text pattern in remote files.

Args: path: File path or directory to search. pattern: Text or regex pattern to search for. recursive: Search recursively in directories (default False). ignore_case: Case-insensitive search (default True). context_lines: Lines of context around each match (default 2). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Matching lines with file names and line numbers.

List running processes sorted by resource usage.

Args: sort_by: Sort field: "cpu" (default), "mem", or "pid". limit: Number of processes to show (default 20). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Process list with PID, user, CPU%, MEM%, and command.

Search for processes by name or keyword.

Args: name: Process name or keyword to search (e.g., "nginx", "python"). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Matching processes with their PIDs and details.

Send a signal to a process by PID.

Args: pid: Process ID to signal. signal: Signal name: "TERM" (graceful, default), "KILL" (force), "HUP" (reload). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Result of the kill command.

List all open listening ports and their associated processes.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Listening ports with protocol, port number, and process name.

Upload a local file to the remote server via SFTP.

Args: local_path: Absolute local file path (on the machine running this MCP server). remote_path: Destination absolute path on the remote server. host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Success message with transferred file size, or error details.

Download a file from the remote server to local via SFTP.

Args: remote_path: Absolute file path on the remote server. local_path: Destination absolute local path (on the machine running this MCP server). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Success message with transferred file size, or error details.

Get detailed metadata of a remote file or directory.

Args: path: Absolute path on the remote server. host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: File metadata: size, permissions, owner, modification time.

Get a comprehensive system overview of the remote server.

Collects hostname, OS release, kernel, uptime, CPU, memory, disk, and load average in one call. Best starting point for system analysis.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Formatted system overview report.

Get detailed CPU usage and statistics.

Returns current CPU load, per-core usage, and top CPU-consuming processes.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: CPU usage report.

Get memory and swap usage details.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Memory usage report including free, used, cached, and swap.

Get disk usage and I/O statistics.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Disk usage per filesystem and I/O stats.

Get network interface status, connections, and statistics.

Args: host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Network interfaces, active connections, and routing table.

Retrieve system logs from journald or /var/log/syslog.

Args: lines: Number of recent log lines to retrieve (default 100). unit: Optional systemd service name to filter logs (e.g., "nginx", "sshd"). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Recent system log entries.

Check the status of a systemd service.

Args: service: Service name (e.g., "nginx", "mysql", "docker"). host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Service status including active state, PID, and recent logs.

Start, stop, restart, or reload a systemd service.

Args: service: Service name (e.g., "nginx", "mysql", "docker"). action: Action to perform: "start", "stop", "restart", "reload", "enable", "disable". host_name: Named host from SSH_HOSTS config; uses default host if omitted.

Returns: Result of the service management action.