Plesk MCP server
✓ 인증됨AI 에이전트를 사용하여 Plesk 호스팅 서버 관리, 셸 명령 실행 및 파일 업로드를 수행할 수 있습니다.
다른 이름 FlayedOne/plesk-mcp
- 스타
- 6
- Tools
- —
- 다운로드, 30일
- 7,689
- 최신 버전
- 0.1.1
- 마지막 커밋
- 2026년 5월 17일
- 라이선스
- MIT
Plesk MCP란?
AI 에이전트를 사용하여 Plesk 호스팅 서버 관리, 셸 명령 실행 및 파일 업로드를 수행할 수 있습니다.
프로젝트 README에서 생성된 요약
Plesk MCP server 정보
plesk-mcp를 사용하면 AI 에이전트를 통해 호스팅 환경을 관리할 수 있으며, 관리자는 자연어를 사용하여 Plesk 서버를 제어할 수 있습니다. 이 서버는 민감한 정보를 사용자의 환경 내에 유지하기 위해 로컬 머신에서 실행됩니다. Plesk REST API 및 WP Toolkit REST API를 통해 호스팅에 연결하여 핵심 관리 작업, 셸 명령 실행 및 파일 업로드를 수행합니다.
서버를 설정하려면 uv Python 패키지 관리자와 유효한 Plesk 호스트 주소가 필요합니다. PLESK_API_KEY를 사용하거나 PLESK_USERNAME 및 PLESK_PASSWORD를 제공하여 인증할 수 있습니다. 이 도구는 Plesk가 실행되는 모든 지원되는 Linux 또는 Windows 운영 체제에서 작동하지만, Plesk Obsidian 18.0.76에서 구체적으로 테스트되었습니다. 여러 환경을 관리하는 사용자의 경우, 설정을 통해 단일 에이전트 구성에 여러 Plesk 서버를 동시에 연결할 수 있습니다.
활용 사례
- 1서버 셸 명령 실행관리자는 AI 에이전트에게 Plesk 호스트에서 특정 터미널 명령을 직접 실행하도록 요청할 수 있습니다.
- 2호스팅으로 파일 업로드개발자는 AI에게 로컬 환경에서 Plesk 서버로 파일을 전송하도록 지시할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Plesk MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Plesk MCP 설치
$ claude mcp add plesk-mcp -- uvx plesk-mcpCursor에 Plesk MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"plesk-mcp": {
"command": "uvx",
"args": [
"plesk-mcp"
]
}
}
}VS Code에 Plesk MCP 설치
.vscode/mcp.json
{
"servers": {
"plesk-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"plesk-mcp"
]
}
}
}VS Code CLI에 Plesk MCP 설치
$ code --add-mcp '{"name":"plesk-mcp","type":"stdio","command":"uvx","args":["plesk-mcp"]}'Claude Desktop에 Plesk MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"plesk-mcp": {
"command": "uvx",
"args": [
"plesk-mcp"
]
}
}
}Codex에 Plesk MCP 설치
$ codex mcp add plesk-mcp -- uvx plesk-mcpCodex config.toml에 Plesk MCP 설치
~/.codex/config.toml
[mcp_servers.plesk-mcp] command = "uvx" args = ["plesk-mcp"]
Gemini CLI에 Plesk MCP 설치
$ gemini mcp add -s user plesk-mcp uvx -- plesk-mcpGemini settings.json에 Plesk MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"plesk-mcp": {
"command": "uvx",
"args": [
"plesk-mcp"
]
}
}
}구성
OPENAI_API_KEYPLESK_API_KEYPlesk API key. Create via `plesk bin secret_key --create -description 'Plesk MCP'` on the server. Required, unless PLESK_USERNAME and PLESK_PASSWORD are provided.
PLESK_HOSTBase URL of your Plesk server. May include port. Example: https://plesk.example.com:8443
PLESK_PASSWORDPassword for authenticating with your Plesk server.
PLESK_USERNAMEUsername for authenticating with your Plesk server. Typically "admin".
| 이름 | 설명 | 유형 |
|---|---|---|
| OPENAI_API_KEY | — | |
| PLESK_API_KEY | Plesk API key. Create via `plesk bin secret_key --create -description 'Plesk MCP'` on the server. Required, unless PLESK_USERNAME and PLESK_PASSWORD are provided. | |
| PLESK_HOST | Base URL of your Plesk server. May include port. Example: https://plesk.example.com:8443 | |
| PLESK_PASSWORD | Password for authenticating with your Plesk server. | |
| PLESK_USERNAME | Username for authenticating with your Plesk server. Typically "admin". |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능flayedone/plesk-mcp is public and reachablegithub.com/flayedone/plesk-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시plesk-mcp names flayedone/plesk-mcp as sourcepypi.org/project/plesk-mcp/ ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-05-17github.com/flayedone/plesk-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from plesk-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음66 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기Plesk MCP Server
This MCP server for Plesk allows administrators to manage their Plesk servers using various AI agents and apps. It builds on top of Plesk REST API and WP Toolkit REST API, and provides core administration capabilities, as well as ability to manage the server through shell commands and upload files to the server.
The MCP server runs locally on your machine, so important information doesn't leave your environment.
Plesk Requirements
The MCP server is expected to support any sufficiently recent Plesk version (there are no strict limitations) and any OS (Linux or Windows) that Plesk supports. However, it was tested only on Plesk Obsidian 18.0.76, so prefer using a supported Plesk version.
Obviously, API access must not be disabled on the server.
MCP Server Requirements
You will need uv Python package manager to run the server. Refer to the official documentation for installation instructions.
Usage
Configure the server in your VS Code mcp.json or equivalent (in other agents or apps) using a configuration like:
{
"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"
}
}
}
}
You may want to use env file (e.g. via "envFile" parameter) if your agent or app supports it. This will avoid putting credentials directly in the config file.
See uvx plesk-mcp@latest --help for details on available options and environment variables.
Recommended Usage
For better behavior, it's recommended to use this MCP server in combination with a documentation MCP server. Select either plesk-local-docs-mcp or plesk-remote-docs-mcp. This will allow the agent to get more accurate information about Plesk usage when needed.
You may also attach several Plesk servers at once if needed (e.g. for managing multiple servers).
Here's an example configuration:
{
"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"
}
}
}
}
Development
MCP server run command:
uv run plesk-mcp --log-level debug --insecure
Before commit:
uv run ruff format
uv run ruff check --fix
uv run mypy .
uv run pytest
Publish:
uv build --clear
uv publish
mcp-publisher login github
mcp-publisher publish
Testing
Using Plesk Docker Image
If you don't have a Plesk instance but want to test this MCP server, you may use Plesk Docker image instead:
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
The Docker image startup is not instant, so give it a minute or so before trying to connect.
And then configure the MCP server as:
{
"servers": {
"plesk": {
"command": "uvx",
"args": [
"plesk-mcp@latest",
"--insecure"
],
"env": {
"PLESK_HOST": "https://localhost:8443",
"PLESK_PASSWORD": "changeme1Q**"
}
}
}
}
Without Plesk Server (Demo Mode)
Alternatively, run in demo mode from sources (with mocked responses):
{
"servers": {
"plesk": {
"command": "uv",
"args": [
"run",
"plesk-mcp"
],
"env": {
"PLESK_HOST": "https://linux.demo.example.net",
"PLESK_API_KEY": "-"
}
}
}
}
Automated tests
Unit tests run with uv run pytest (in the project root and in each sub-project). Smoke tests that exercise real services are skipped by default and selected via -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
Plesk MCP 질문
Plesk MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add plesk-mcp -- uvx plesk-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Plesk MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.