Plesk MCP Server (v2.1.0)

The Plesk MCP Server is a professional-grade Model Context Protocol (MCP) implementation that bridges Large Language Models (LLMs) with a Plesk server using a hybrid approach: REST API for standard management and SSH for deep system-level operations.

🚀 Value Proposition: Proactive Infrastructure Governance

Version 2.1.0 transforms the AI into a full-fledged System Administrator. By combining API calls with direct shell execution, it eliminates the "blind spots" of standard APIs.

Key Capabilities:

• Smarter Security: Full Fail2Ban management (Unban/Whitelist) and Firewall rule control.

• Deep Health Monitoring: Proactive detection of Disk space and Inode exhaustion to prevent production crashes.

• Subscription Insight: Direct access to internal Plesk subscription lists to identify suspended accounts.

• System Control: Direct service restarts and manual backup triggers.

🛠️ Toolset Overview

🛡️ Security & SSH Tools (Hybrid)

• plesk_list_suspended_subscriptions: Uses SSH to fetch the real status of all subscriptions.

• plesk_fail2ban_unban_ip: Restores access for blocked IPs.

• plesk_fail2ban_whitelist_ip: Ensures trusted IPs are never banned.

• plesk_firewall_list_rules: Audit current server traffic rules.

📊 Health Observability

• plesk_server_health_detailed: Deep check of CPU, RAM, Disk, and Inodes.

• plesk_server_status: General system uptime and stability.

🌐 DNS, Mail & Backups

• plesk_dns_get_records: Retrieve DNS configurations.

• plesk_mail_queue_status: Monitor outbound mail delivery.

• plesk_backup_trigger: Execute immediate domain backups.

• plesk_list_domains: List all hosted domains.

⚙️ Configuration

Environment Variables

The server requires both REST and SSH credentials:

• PLESK_URL: Base URL (e.g., https://plesk.example.com:8443/)

• PLESK_API_KEY: Plesk REST API key.

• PLESK_SSH_HOST: Server IP or Hostname.

• PLESK_SSH_PORT: SSH port (usually 22).

• PLESK_SSH_USER: SSH username (e.g., root).

• PLESK_SSH_PASSWORD: SSH password (or use PLESK_SSH_KEY).

• PLESK_SSH_KEY: Private SSH key string.

🏗️ Implementation Details

• Transport: Stdio

• Protocols: REST API v2 + SSH (Secure Shell)

• Language: Node.js (ES Modules)

• Client: Axios & ssh2

---
Alejandro Trujillo Jiménez
Klan1 Labs - R&D Team
Website: klan1.com