# 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](https://klan1.com)**