Skip to main content
Glama

Plesk MCP 서버

Plesk를 위한 이 MCP 서버를 사용하면 관리자가 다양한 AI 에이전트와 앱을 사용하여 Plesk 서버를 관리할 수 있습니다. 이 서버는 Plesk REST API 및 WP Toolkit REST API를 기반으로 구축되었으며, 핵심 관리 기능뿐만 아니라 셸 명령을 통해 서버를 관리하고 서버에 파일을 업로드하는 기능을 제공합니다.

MCP 서버는 로컬 머신에서 실행되므로 중요한 정보가 환경 외부로 유출되지 않습니다.

Plesk 요구 사항

MCP 서버는 비교적 최근의 모든 Plesk 버전(엄격한 제한 없음)과 Plesk가 지원하는 모든 OS(Linux 또는 Windows)를 지원할 것으로 예상됩니다. 그러나 Plesk Obsidian 18.0.76에서만 테스트되었으므로 지원되는 Plesk 버전을 사용하는 것을 권장합니다.

당연히 서버에서 API 액세스가 비활성화되어 있어서는 안 됩니다.

MCP 서버 요구 사항

서버를 실행하려면 uv Python 패키지 관리자가 필요합니다. 설치 지침은 공식 문서를 참조하세요.

사용법

VS Code mcp.json 또는 (다른 에이전트나 앱의 경우) 이에 상응하는 설정 파일에 다음과 같이 서버를 구성하세요:

{
    "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"
            }
        }
    }
}

에이전트나 앱이 지원하는 경우 env 파일(예: "envFile" 매개변수 사용)을 사용하는 것이 좋습니다. 이렇게 하면 구성 파일에 자격 증명을 직접 입력하지 않아도 됩니다.

사용 가능한 옵션 및 환경 변수에 대한 자세한 내용은 uvx plesk-mcp@latest --help를 참조하세요.

권장 사용법

더 나은 동작을 위해 이 MCP 서버를 문서 MCP 서버와 함께 사용하는 것이 좋습니다. plesk-local-docs-mcp 또는 plesk-remote-docs-mcp 중 하나를 선택하세요. 이렇게 하면 에이전트가 필요할 때 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 build --clear
uv publish
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 이미지 시작에는 시간이 조금 걸리므로 연결을 시도하기 전에 1분 정도 기다려 주세요.

그런 다음 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": "-"
            }
        }
    }
}
Install Server
A
license - permissive license
A
quality
C
maintenance

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/FlayedOne/plesk-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server