linux-mcp-server

linux-mcp-server is a local MCP server: MCP server for read-only Linux system administration, diagnostics, and troubleshooting. Install it from pypi as linux-mcp-server.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add linux-mcp-server -e LINUX_MCP_USER=... -e LINUX_MCP_SSH_KEY_PATH=... -e LINUX_MCP_KEY_PASSPHRASE=... -e LINUX_MCP_SEARCH_FOR_SSH_KEY=... -e LINUX_MCP_COMMAND_TIMEOUT=... -e LINUX_MCP_VERIFY_HOST_KEYS=... -e LINUX_MCP_KNOWN_HOSTS_PATH=... -e LINUX_MCP_ALLOWED_LOG_PATHS=... -e LINUX_MCP_LOG_DIR=... -e LINUX_MCP_LOG_LEVEL=... -e LINUX_MCP_LOG_RETENTION_DAYS=... -- uvx linux-mcp-server

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

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

Fill in the environment variables with your own credentials.

• Runtime: Python with uv (runs with uvx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: 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