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

Plesk

Plesk MCPサーバー

Pleskの要件

MCPサーバーの要件

使用方法

推奨される使用方法

開発

テスト

Plesk Dockerイメージの使用

Pleskサーバーなし（デモモード）

Resources

Tools

Latest Blog Posts

MCP directory API