Awesome Linux MCP Server

# Linux MCP Projects Overview This document provides a comprehensive overview of various Model Context Protocol (MCP) server implementations focused on Linux system integration, automation, and remote management capabilities. ## Table of Contents - [Terminal & Command Execution](#terminal--command-execution) - [Browser Automation](#browser-automation) - [SSH & Remote Access](#ssh--remote-access) - [Penetration Testing](#penetration-testing) - [Notes & File Management](#notes--file-management) - [Project Comparison Matrix](#project-comparison-matrix) --- ## Terminal & Command Execution ### 1. MCP Terminal Server (dillip285) **Repository**: `dillip285 - mcp-terminal-main/` **Core Capabilities**: - 🔒 **Secure command execution** with configurable path restrictions - 📁 **File system operations** within allowed directories - 🌍 **Environment variable management** - 💻 **Cross-platform support** (Windows, macOS, Linux) - 🔌 **Remote system connections** via SSH and command execution **Key Features**: - Secure terminal interface for AI models - Path-based access control - Command validation and sanitization - Integration with Claude Desktop - NPM-published package for easy installation **Primary Tools**: - `execute_command` - Run terminal commands securely (including SSH and remote commands) **Use Cases**: - Controlled terminal access for AI assistants - Secure command execution in sandboxed environments - Remote system administration through AI --- ### 2. Linux Bash MCP Server (gunjanjp) **Repository**: `gunjanjp - linuxshell-mcp-master/` **Core Capabilities**: - 🐧 **Universal Linux support** - Ubuntu, Debian, Fedora, openSUSE, Alpine, Kali - 🔍 **Smart distribution detection** - Auto-detects WSL distributions - 🛡️ **Safe configuration** - Preserves existing MCP servers - 🔧 **Comprehensive diagnostics** - Built-in troubleshooting tools - ⚡ **High-performance execution** with configurable timeouts **Key Features**: - WSL2 integration for Windows users - Auto-fix utilities for common issues - Interactive setup wizard - Debug mode and logging - Multiple Linux distribution support **Available Tools**: - `execute_bash_command` - Run single bash commands - `execute_bash_script` - Execute bash scripts with arguments - `create_bash_script` - Create new bash scripts - `list_directory` - List directory contents - `get_system_info` - Comprehensive system information - `check_wsl_status` - WSL and distribution status **Use Cases**: - Linux command execution on WSL2 systems - System administration automation - Development environment management - Educational Linux learning through AI --- ### 3. Linux Command MCP (xkiranj) **Repository**: `xkiranj - linux-command-mcp-main/` **Core Capabilities**: - 🖥️ **Remote command execution** system - 🔒 **Secure MCP-based** command interface - 📊 **Client-server architecture** with PM2 management - 🛠️ **Command-line client** for direct interaction **Key Features**: - Separate client and server components - PM2 process management - Standardized MCP protocol implementation - Command execution with output capture **Available Commands**: - `exec <command>` - Execute Linux commands - `list [directory]` - List directory contents - `help` - Show help information - `exit` - Exit client **Use Cases**: - Remote Linux system management - Educational command-line learning - Development server monitoring - Automated system diagnostics --- ## Browser Automation ### 4. MCP-Puppeteer-Linux (PhialsBasement) **Repository**: `PhialsBasement - MCP-Puppeteer-Linux-main/` **Core Capabilities**: - 🌐 **Browser automation** using Puppeteer - 🐧 **Linux display server support** (X11 and Wayland) - 📸 **Screenshot capture** capabilities - 🖱️ **Web interaction** (navigation, clicking, form filling) - 💻 **JavaScript execution** in browser context **Key Features**: - Automatic X11/Wayland detection and configuration - Console log monitoring - Element-based screenshot capture - Form filling and selection - Headless browser automation **Available Tools**: - `puppeteer_navigate` - Navigate to URLs - `puppeteer_screenshot` - Capture screenshots - `puppeteer_click` - Click elements - `puppeteer_hover` - Hover elements - `puppeteer_fill` - Fill input fields - `puppeteer_select` - Select form options - `puppeteer_evaluate` - Execute JavaScript **Resources**: - `console://logs` - Browser console output - `screenshot://<name>` - Captured screenshots **Use Cases**: - Web scraping and automation - UI testing and validation - Web application monitoring - Automated browser interactions --- ## SSH & Remote Access ### 5. SSH MCP Server (tufantunc) **Repository**: `tufantunc - ssh-mcp-main/` **Core Capabilities**: - 🔐 **SSH-based remote command execution** - 🖥️ **Cross-platform support** (Linux and Windows servers) - ⏱️ **Configurable timeout protection** - 🔑 **Multiple authentication methods** (password/key-based) **Key Features**: - Built with TypeScript and official MCP SDK - Graceful process termination on timeout - Configurable command length limits - Comprehensive error handling - NPM-published package **Available Tools**: - `exec` - Execute shell commands on remote servers **Configuration Options**: - Host, port, user credentials - Authentication via password or SSH key - Command execution timeouts - Maximum command length limits **Use Cases**: - Remote server management - Automated deployment scripts - Infrastructure monitoring - Secure remote administration --- ### 6. Linux Server MCP Server (wfqdreamcity) **Repository**: `wfqdreamcity - linux-server-MCP-Server-master/` **Core Capabilities**: - 📝 **Notes system** implementation - 🔗 **SSH-based Linux server** integration - 📄 **Resource management** via URI schemes - 🛠️ **Note creation and management** tools **Key Features**: - SSH private key authentication - Note storage and retrieval - MCP resource and tool patterns - TypeScript-based implementation **Available Tools**: - `create_note` - Create text notes - `summarize_notes` - Generate note summaries **Resources**: - `note://` URIs for accessing stored notes **Use Cases**: - Note-taking and documentation - Remote server information storage - Knowledge management systems - Documentation automation --- ## Penetration Testing ### 7. MCP Kali Server (Wh0am123) **Repository**: `Wh0am123 - MCP-Kali-Server-main/` **Core Capabilities**: - 🕵️ **Penetration testing** tool integration - 🐧 **Kali Linux** command execution - 🖥️ **API bridge** for offensive security tools - 🤖 **AI-assisted security testing** **Key Features**: - REST API server for Kali tools - MCP client for AI integration - Offensive security automation - CTF challenge solving support **Available Tools**: - `nmap_scan` - Network scanning - `gobuster_scan` - Directory enumeration - `dirb_scan` - Web content scanning - `nikto_scan` - Web server scanning - `sqlmap_scan` - SQL injection testing - `metasploit_run` - Metasploit module execution - `hydra_attack` - Password cracking - `john_crack` - Hash cracking - `wpscan_analyze` - WordPress vulnerability scanning - `enum4linux_scan` - Windows/Samba enumeration - `server_health` - API server status - `execute_command` - Arbitrary command execution **Use Cases**: - Automated penetration testing - CTF challenge solving - Vulnerability assessment - Offensive security research - AI-assisted security automation --- ## Project Comparison Matrix | Project | Language | Primary Focus | Authentication | Platform Support | Key Tools | |---------|----------|---------------|----------------|------------------|-----------| | **MCP Terminal** | TypeScript | Secure Terminal | Path-based | Cross-platform | execute_command | | **Linux Bash MCP** | JavaScript | WSL2 Bash | Distribution detection | Windows (WSL2) | 6 bash tools | | **Linux Command MCP** | TypeScript | Remote Commands | None specified | Linux | exec, list | | **MCP-Puppeteer-Linux** | TypeScript | Browser Automation | Display server | Linux (X11/Wayland) | 7 browser tools | | **SSH MCP** | TypeScript | Remote SSH | SSH keys/passwords | Linux/Windows | exec | | **Linux Server MCP** | TypeScript | Notes System | SSH keys | Linux | create_note, summarize_notes | | **MCP Kali** | Python | Penetration Testing | API-based | Kali Linux | 12 security tools | ## Technical Implementation Patterns ### Common MCP Patterns Used: - **Tools**: Executable functions exposed to AI models - **Resources**: Data accessible via URI schemes - **Authentication**: SSH, API keys, path restrictions - **Error Handling**: Timeout protection, graceful failures - **Configuration**: JSON-based server configurations ### Architecture Approaches: - **Client-Server**: xkiranj (separate client/server) - **Direct MCP**: Most others (direct MCP server) - **API Bridge**: Wh0am123 (REST API to MCP) - **Tool Aggregation**: Multiple specialized tools per server ## Getting Started Each project includes: - 📖 **README.md** with setup instructions - ⚙️ **package.json** for dependencies - 🔧 **Configuration examples** for Claude Desktop - 🧪 **Testing utilities** where applicable ## Contributing & Community These projects demonstrate the versatility of the MCP protocol for Linux system integration, from basic command execution to specialized security tooling. Each implementation showcases different approaches to AI-Linux integration while maintaining security and usability standards. --- *This overview covers MCP server implementations focused on Linux system capabilities. Each project serves different use cases while following MCP best practices for AI system integration.*