MCP server for read-only Linux system administration, diagnostics, and troubleshooting
Connect Runs on your machine
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=<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
{
"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": "<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>"
}
}
}
}
{
"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": "<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>"
}
}
}
}
{
"servers": {
"linux-mcp-server": {
"type": "stdio",
"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": "<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>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
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 |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 9 Apr 2026 |
| Last updated | 9 Apr 2026 |
| Registry name | io.github.rhel-lightspeed/linux-mcp-server |
More other servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
