Obambu cPanel MCP

obambu-cpanel-mcp

AI アシスタント（Claude など）から cPanel UAPI を通じて cPanel ホスティングアカウントを管理できる、Model Context Protocol（MCP）サーバーです。

ドメイン、DNS ゾーン、メールアカウント、MySQL データベース、ファイル一覧を操作するツールに加え、ほかの UAPI モジュールや関数を呼び出すための汎用的な手段も提供します。

必要条件

• Node.js 18+
• API トークンにアクセスできる cPanel アカウント（cPanel の「Security → Manage API Tokens」）

cPanel の認証情報の取得方法（Obambu の例）

以下の 4 つの環境変数は、どの cPanel ホストからでも取得できますが、ここでは Obambu での確認方法を説明します。

• CPANEL_HOST — サーバーのホスト名です。例：cp4.obambu.com（または https://yourdomain.com:2083 で cPanel にアクセスできる場合は、ご自身のドメイン）。Obambu から届いたウェルカムメールで確認するか、ドメインの DNS ゾーンで cpanel という名前の A レコード（例：cpanel.yourdomain.com）を探してください。同じサーバーは cpX.obambu.com というホスト名でも応答します。
• CPANEL_PORT — 00000（cPanel のデフォルトの HTTPS ポート）です。ホストから別途指示がない限り、変更しないでください。
• CPANEL_USERNAME — cPanel アカウントのユーザー名です。cPanel にログインしたときに右上に表示されるほか、ホスティングアカウントの作成時に Obambu から届いたウェルカムメールにも記載されています。
• CPANEL_API_TOKEN — ご自身で生成してください。cPanel のパスワードとは異なります。
  1. https://<CPANEL_HOST>:00000 から cPanel にログインします
  2. Security → Manage API Tokens に移動します
  3. Create をクリックし、名前（例：mcp-server）を付けます。必要に応じて特定の ACL のみに制限してから、Create をクリックします
  4. トークンをすぐにコピーします。cPanel で表示されるのは一度だけです

MCP クライアントでの使用（npx、推奨）

obambu-cpanel-mcp として npm で公開されています。クローンやビルドは不要です。MCP クライアントの設定（例：Claude Desktop / Claude Code）に追加してください。

{
  "mcpServers": {
    "obambu-cpanel": {
      "command": "npx",
      "args": ["-y", "obambu-cpanel-mcp"],
      "env": {
        "CPANEL_HOST": "your-server-hostname-or-ip",
        "CPANEL_PORT": "00000",
        "CPANEL_USERNAME": "your-cpanel-username",
        "CPANEL_API_TOKEN": "your-api-token"
      }
    }
  }
}

ソースからの実行

git clone https://github.com/RodrigueDev13/obambu-cpanel-mcp.git
cd obambu-cpanel-mcp
npm install
cp .env.example .env

.env を cPanel の情報で編集してから、次を実行します。

npm run build
npm start

ビルドせずにローカル開発を行う場合：

npm run dev

ソースから実行する場合は、npx の代わりにビルド済みのエントリーポイントを MCP クライアントに指定します。

{
  "mcpServers": {
    "obambu-cpanel": {
      "command": "node",
      "args": ["/absolute/path/to/obambu-cpanel-mcp/dist/index.js"],
      "env": {
        "CPANEL_HOST": "your-server-hostname-or-ip",
        "CPANEL_PORT": "00000",
        "CPANEL_USERNAME": "your-cpanel-username",
        "CPANEL_API_TOKEN": "your-api-token"
      }
    }
  }
}

利用可能なツール

ツール	説明
get_account_summary	ディスク／帯域幅のクォータ使用量と一般的な統計情報
list_domains	ドメイン、サブドメイン、アドオンドメイン、パークドメイン
list_dns_records	ドメインの DNS ゾーンを読み取ります
add_dns_record	DNS レコードを追加します
edit_dns_record	既存の DNS レコードを編集します
remove_dns_record	DNS レコードを削除します
list_emails	メールアカウントの一覧を表示します
create_email	メールアカウントを作成します
delete_email	メールアカウントを削除します
list_files	アカウントのホームディレクトリ内のファイル／ディレクトリを一覧表示します
list_databases	MySQL データベースの一覧を表示します
list_database_users	MySQL データベースユーザーの一覧を表示します
create_database	MySQL データベースを作成します
create_database_user	MySQL データベースユーザーを作成します
grant_database_privileges	データベースに対する権限をユーザーに付与します
cpanel_uapi_call	上記で対応していない処理について、任意の UAPI モジュール／関数を直接呼び出します

使用例

接続したら、アシスタントに自然な言葉で話しかけるだけで、適切なツールが選ばれます。

• 「cPanel アカウントへの接続をテストして」 → get_account_summary
• 「このホスティングアカウントに登録されているドメインとサブドメインを教えて」 → list_domains
• 「example.com の DNS レコードを表示して」 → list_dns_records
• 「shop.example.com が 1.2.3.4 を指す A レコードを追加して」 → add_dns_record
• 「[email protected] のメールボックスを作成して」 → create_email
• 「新しいアプリ用の MySQL データベースとユーザーを作成して、権限を付与して」 → create_database + create_database_user + grant_database_privileges
• 「public_html 内のファイルを一覧表示して」 → list_files
• 「config/filesystems.php を読み込んで、このパスを修正して」 → module: "Fileman", function: "get_file_content" / save_file_content を指定した cpanel_uapi_call

ツール呼び出しは UAPI モジュールに直接対応しているため、実際の移行やデプロイのワークフローにも役立ちます。たとえば、新しい cPanel アカウントへのサイト移行、新しいアプリ用のデータベースのプロビジョニング、ドメイン切り替え前の DNS 監査などに利用できます。

Fileman に関する注意事項

個々のファイルの読み書きで確実に動作することが確認されているのは、list_files（Fileman::list_files を使用）と、cpanel_uapi_call のエスケープハッチ経由の get_file_content / save_file_content のみです。ファイルシステムの一括操作（extract_files、rename、mkdir、fileop、delete_files など）は、cPanel のバージョンやプロバイダーによって利用できるとは限りません。依存する前にテストし、一括移動、展開、削除には cPanel のファイルマネージャー UI を利用してください。

セキュリティ

• .env ファイルは絶対にコミットしないでください（デフォルトで git の追跡対象外です）。
• cPanel API トークンの権限は、プロバイダーが許可する範囲で最小限にしてください。
• cpanel_uapi_call ツールは、アカウントで利用可能な任意の UAPI 関数を呼び出せます。直接 API やトークンにアクセスする場合と同様に、慎重に取り扱ってください。

ライセンス

MIT