Plesk

Plesk MCP 服务

这个适用于 Plesk 的 MCP 服务允许管理员使用各种 AI Agent 和应用管理其 Plesk 服务。它基于 Plesk REST API 和 WP Toolkit REST API 构建，提供核心管理功能，还可以通过 shell 命令管理服务并向服务上传文件。

MCP 服务在你的计算机上本地运行，因此重要信息不会离开你的环境。

Plesk 要求

MCP 服务预期支持所有足够新的 Plesk 版本（没有严格限制），以及 Plesk 支持的所有操作系统（Linux 或 Windows）。不过，它只在 Plesk Obsidian 18.0.76 上经过测试，因此建议使用受支持的 Plesk 版本。

显然，服务上不得禁用 API 访问。

MCP 服务要求

你需要使用 Python 包管理器 uv 来运行服务。安装说明请参阅官方文档。

用法

使用如下配置，在 VS Code 的 mcp.json 或其他 Agent 或应用中的等效文件里配置服务：

{
    "servers": {
        "plesk": {
            "command": "uvx",
            "args": [
                "plesk-mcp@latest"
            ],
            "env": {
                // Base URL of your Plesk server. May include port.
                // If you don't have a valid TLS certificate or want to use HTTP,
                // add the --insecure flag to the args above.
                // However, this is not recommended as you credentials may be leaked as a result.
                "PLESK_HOST": "https://plesk.example.net:8443",
                // API key (recommended).
                // Create via `plesk bin secret_key --create -description 'Plesk MCP'` on the server.
                "PLESK_API_KEY": "00000000-0000-0000-0000-000000000000",
                // Alternatively, you can use username and password.
                "PLESK_USERNAME": "admin",
                "PLESK_PASSWORD": "passwd"
            }
        }
    }
}

如果你的 Agent 或应用支持，可以使用 env 文件（例如通过 "envFile" 参数），以免将凭据直接写入配置文件。

有关可用选项和环境变量的详细信息，请参阅 uvx plesk-mcp@latest --help。

推荐用法

为获得更好的使用效果，建议将此 MCP 服务与文档 MCP 服务搭配使用。选择 plesk-local-docs-mcp 或 plesk-remote-docs-mcp。这样，Agent 就能在需要时获取有关 Plesk 用法的更准确的信息。

你也可以根据需要同时连接多个 Plesk 服务（例如，用于管理多个服务）。

配置示例：

{
    "servers": {
        "plesk-docs": {
            "command": "uvx",
            "args": [
                "plesk-local-docs-mcp@latest"
            ],
            "env": {
                "OPENAI_API_KEY": "sk-..."
            }
        },
        "plesk1": {
            "command": "uvx",
            "args": [
                "plesk-mcp@latest"
            ],
            "env": {
                "PLESK_HOST": "https://plesk1.example.net:8443",
                "PLESK_API_KEY": "00000000-0000-0000-0000-000000000000"
            }
        },
        "plesk2": {
            "command": "uvx",
            "args": [
                "plesk-mcp@latest"
            ],
            "env": {
                "PLESK_HOST": "https://plesk2.example.net",
                "PLESK_USERNAME": "admin",
                "PLESK_PASSWORD": "passwd"
            }
        }
    }
}

开发

MCP 服务运行命令：

uv run plesk-mcp --log-level debug --insecure

提交前：

uv run ruff format
uv run ruff check --fix
uv run mypy .
uv run pytest

发布：

uv build --clear
uv publish
mcp-publisher login github
mcp-publisher publish

测试

使用 Plesk Docker 镜像

如果你没有 Plesk 实例，但想测试此 MCP 服务，可以改用 Plesk Docker 镜像：

docker run -d --rm --tmpfs /tmp --tmpfs /run --tmpfs /run/lock -v /sys/fs/cgroup:/sys/fs/cgroup --cgroupns host -p 80:80 -p 443:443 -p 8880:8880 -p 8443:8443 --name plesk plesk/plesk

Docker 镜像启动并非即时完成，因此请等待大约一分钟后再尝试连接。

然后按如下方式配置 MCP 服务：

{
    "servers": {
        "plesk": {
            "command": "uvx",
            "args": [
                "plesk-mcp@latest",
                "--insecure"
            ],
            "env": {
                "PLESK_HOST": "https://localhost:8443",
                "PLESK_PASSWORD": "changeme1Q**"
            }
        }
    }
}

没有 Plesk 服务（演示模式）

也可以从源代码以演示模式运行（使用模拟响应）：

{
    "servers": {
        "plesk": {
            "command": "uv",
            "args": [
                "run",
                "plesk-mcp"
            ],
            "env": {
                "PLESK_HOST": "https://linux.demo.example.net",
                "PLESK_API_KEY": "-"
            }
        }
    }
}

自动化测试

单元测试使用 uv run pytest 运行（在项目根目录和每个子项目中）。默认跳过会调用真实服务的冒烟测试，可通过 -m smoke 选择运行：

# Plesk MCP smoke tests (against a reachable Plesk instance, e.g. from the Docker image described above)
PLESK_HOST=https://localhost:8443 PLESK_PASSWORD='changeme1Q**' PLESK_INSECURE=1 \
    uv run pytest -m smoke