📦
io.github.rhel-lightspeed/linux-mcp-server
MCP server for read-only Linux system administration, diagnostics, and troubleshooting
0 installs
Trust: 37 — Low
Devtools
Ask AI about io.github.rhel-lightspeed/linux-mcp-server
Powered by Claude · Grounded in docs
I know everything about io.github.rhel-lightspeed/linux-mcp-server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
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 AI agents (Claude, Goose), and troubleshooting.
Available Tools
System Information
get_system_information- OS version, kernel, hostname, uptimeget_cpu_information- CPU details and load averagesget_memory_information- RAM usage and swap detailsget_disk_usage- Filesystem usage and mount pointsget_hardware_information- Hardware details (CPU architecture, PCI/USB devices, memory hardware)
Service Management
list_services- List all systemd services with statusget_service_status- Detailed status of a specific serviceget_service_logs- Recent logs for a specific service
Process Management
list_processes- Running processes with CPU/memory usageget_process_info- Detailed information about a specific process
Logs & Audit
get_journal_logs- Query systemd journal with filtersget_audit_logs- Read audit logs (if available)read_log_file- Read specific log file (whitelist-controlled)
Network Diagnostics
get_network_interfaces- Network interface informationget_network_connections- Active network connectionsget_listening_ports- Ports listening on the system
Storage & Disk Analysis
list_block_devices- Block devices and partitionslist_directories- List directories under a specified path with various sorting options
Key Components
- FastMCP Server: Core MCP protocol server handling tool registration and invocation
- Tool Categories: Six categories of read-only diagnostic tools (system info, services, processes, logs, network, storage)
- SSH Executor: Routes commands to local subprocess or remote SSH execution with connection pooling
- Audit Logger: Comprehensive logging in both human-readable and JSON formats with automatic rotation
- Multi-Target Execution: Single server instance can execute commands on local system or multiple remote hosts
