linux mcp server for Gemini CLI

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

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

client:Gemini CLI transport:stdio runtime:pypi

Install linux mcp server in Gemini CLI

~/.gemini/settings.json · windows: %USERPROFILE%\.gemini\settings.json

LINUX_MCP_USER

LINUX_MCP_SSH_KEY_PATH

LINUX_MCP_KEY_PASSPHRASE

LINUX_MCP_SEARCH_FOR_SSH_KEY

LINUX_MCP_COMMAND_TIMEOUT

LINUX_MCP_VERIFY_HOST_KEYS

LINUX_MCP_KNOWN_HOSTS_PATH

LINUX_MCP_ALLOWED_LOG_PATHS

LINUX_MCP_LOG_DIR

LINUX_MCP_LOG_LEVEL

LINUX_MCP_LOG_RETENTION_DAYS

Held in this page only — never stored, logged, or sent anywhere but back to your screen.

{
  "mcpServers": {
    "linux-mcp-server": {
      "command": "uvx",
      "args": [
        "linux-mcp-server"
      ],
      "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>"
      }
    }
  }
}

Gemini expands $VAR and ${VAR} inside env values, so a secret can live in your shell rather than this file. Gemini CLI docs

linux mcp server in other clients

linux mcp server MCP server