Linux Desktop
Provides AI assistants with the ability to control Linux desktop environments through tools for file management, application launching, and system operations like clipboard access. It includes a multi-level security model to manage permissions for sa
What is Linux Desktop?
Linux Desktop is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to provides ai assistants with the ability to control linux desktop environments through tools for file management, application launching, and system operations like clipboard access. it includes a multi...
Provides AI assistants with the ability to control Linux desktop environments through tools for file management, application launching, and system operations like clipboard access. It includes a multi-level security model to manage permissions for sa
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Provides AI assistants with the ability to control Linux des
Use Cases
Maintainer
Works with
Installation
PIP
pip install linux-mcp-serverManual Installation
pip install linux-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Linux Desktop
The Linux MCP Server is a read-only diagnostic tool that gives AI assistants safe, structured access to Linux system information — covering running services, processes, logs, network state, and storage — without any risk of modifying the system. Built with a RHEL-first focus by the Red Hat Lightspeed team, it supports both local and remote multi-host SSH-based access so AI clients can inspect servers they cannot directly touch. System administrators and DevOps engineers use it to let AI assistants diagnose problems, analyze logs, and answer questions about system health without granting write access.
Prerequisites
- A Linux host (RHEL/CentOS/Fedora or compatible) to be inspected
- Python 3.10+ and the uv tool installed on the machine running the MCP server
- SSH key-based authentication configured if connecting to remote hosts
- An MCP-compatible AI client such as Claude Desktop or Cursor
- The linux-mcp-server package installed via uv
Install linux-mcp-server with uv
Use the uv tool installer to install the linux-mcp-server package. This places the binary at ~/.local/bin/linux-mcp-server.
uv tool install linux-mcp-serverIdentify which log files to allow
The server controls log file access through the LINUX_MCP_ALLOWED_LOG_PATHS environment variable. Decide which log paths your AI client should be able to read. By default, no logs are accessible until you specify paths.
# Example: allow access to system messages and login logs
export LINUX_MCP_ALLOWED_LOG_PATHS="/var/log/messages,/var/log/lastlog"Add the server to your MCP client configuration
Edit your MCP client's config file to register linux-mcp-server. Set LINUX_MCP_ALLOWED_LOG_PATHS to the comma-separated list of log files the AI assistant may read.
Restart your MCP client
After saving the configuration, restart Claude Desktop or your MCP client so it picks up the new server definition. The Linux Tools server should appear in the server list.
Verify connectivity with a diagnostic prompt
Ask the AI assistant to retrieve basic system information. A successful response confirms the server is running and the client is connected.
Linux Desktop Examples
Client configuration
Register linux-mcp-server in Claude Desktop's configuration file, allowing access to two log files.
{
"mcpServers": {
"Linux Tools": {
"command": "/home/YOUR_USER/.local/bin/linux-mcp-server",
"env": {
"LINUX_MCP_ALLOWED_LOG_PATHS": "/var/log/messages,/var/log/lastlog"
}
}
}
}Prompts to try
Use these prompts with your AI assistant once the server is connected. All operations are read-only.
- "Show me the top 10 processes by CPU usage on this system."
- "List all systemd services that are currently failed."
- "What does the last 50 lines of /var/log/messages say?"
- "Give me a summary of disk usage across all mounted filesystems."
- "Check the network interfaces and show their IP addresses and link state."Troubleshooting Linux Desktop
Server starts but AI assistant reports no tools available
Confirm the binary path in the config matches the actual install location. Run 'which linux-mcp-server' or check ~/.local/bin/. The path must be the absolute path to the binary, not a shell alias.
Log file access is denied even though the path is in LINUX_MCP_ALLOWED_LOG_PATHS
Check that the user running the MCP server process has read permissions on those log files. On RHEL systems, /var/log/messages may require the user to be in the adm group.
Remote host SSH connection fails
Ensure key-based SSH authentication is configured between the MCP server host and the remote machine. The SSH key must be accessible without a passphrase prompt, or use ssh-agent to handle the passphrase.
Frequently Asked Questions about Linux Desktop
What is Linux Desktop?
Linux Desktop is a Model Context Protocol (MCP) server that provides ai assistants with the ability to control linux desktop environments through tools for file management, application launching, and system operations like clipboard access. it includes a multi-level security model to manage permissions for sa It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Linux Desktop?
Install via pip with: pip install linux-mcp-server. Then configure your AI client to connect to this MCP server.
Which AI clients work with Linux Desktop?
Linux Desktop works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Linux Desktop free to use?
Yes, Linux Desktop is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Linux Desktop Alternatives — Similar File Systems Servers
Looking for alternatives to Linux Desktop? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Linux Desktop in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Linux Desktop?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.