cPanel管理工具

一个全面的cPanel和WHM管理工具,提供47个UAPI和WHM工具,用于用户级和服务器级操作。

  • by ExpertVagabond
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 ExpertVagabond/cpanel-mcp

使用说明

cpanel mcp

最完整的cPanel MCP服务器——UAPI+WHM上的47个工具。几乎是最接近的竞争对手的2倍。


通过模型上下文协议进行全面的cPanel和WHM管理。36个用于用户级操作(电子邮件、DNS、MySQL、SSL、文件、FTP、cron、域、PHP、备份)的UAPI工具,以及11个用于服务器管理(帐户、包、服务)的WHM工具。提供npm、PyPI和Go包。

安装

npx cpanel-mcp          # TypeScript (npm)
uvx cpanel-mcp          # Python (PyPI)
go install github.com/ExpertVagabond/cpanel-mcp/cmd/cpanel-mcp@latest  # Go

配置

添加 claude_desktop_config.json 或 ~/.mcp.json:

{
  "mcpServers": {
    "cpanel": {
      "command": "npx",
      "args": ["-y", "cpanel-mcp"],
      "env": {
        "CPANEL_HOST": "server.example.com",
        "CPANEL_USERNAME": "myuser",
        "CPANEL_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

环境变量

变量 必填 默认 描述
CPANEL_HOST 是 -- 服务器主机名
CPANEL_USERNAME 是 -- cPanel用户名
CPANEL_API_TOKEN 是 -- API令牌
CPANEL_PORT 没有 2083 UAPI端口
CPANEL_WHM_PORT 没有 2087 WHM API端口
CPANEL_WHM_USERNAME 没有 root WHM用户名
CPANEL_VERIFY_SSL 没有 false 验证TLS证书

工具参考

UAPI——用户级(36个工具)

类别 工具 计数
电子邮件 cpanel_email_list_accounts cpanel_email_create_account cpanel_email_delete_account cpanel_email_set_quota cpanel_email_list_forwarders cpanel_email_create_forwarder 6
文件 cpanel_files_list cpanel_files_get_content cpanel_files_save cpanel_files_delete 4
MySQL cpanel_mysql_list_databases cpanel_mysql_create_database cpanel_mysql_delete_database cpanel_mysql_list_users cpanel_mysql_create_user cpanel_mysql_set_privileges 6
安全套接层 cpanel_ssl_list_certs cpanel_ssl_install_cert cpanel_ssl_generate_csr 3
域名系统 cpanel_dns_list_zones cpanel_dns_get_records cpanel_dns_add_record cpanel_dns_delete_record 4
领域 cpanel_domains_list cpanel_domains_add_subdomain cpanel_domains_remove_subdomain 3
克龙 cpanel_cron_list_jobs cpanel_cron_add_job cpanel_cron_remove_job 3
备份 cpanel_backups_list cpanel_backups_create 2
文件传输协议 cpanel_ftp_list_accounts cpanel_ftp_create_account cpanel_ftp_delete_account 3
PHP cpanel_php_get_version cpanel_php_set_version 2

WHM——管理级别(11个工具)

类别 工具 计数
账户 cpanel_whm_list_accounts cpanel_whm_create_account cpanel_whm_suspend_account cpanel_whm_terminate_account 4
服务 cpanel_whm_service_status cpanel_whm_restart_service 2
包裹 cpanel_whm_list_packages cpanel_whm_create_package 2
服务器 cpanel_whm_get_hostname cpanel_whm_load_average cpanel_whm_version 3

用法示例

You: List all email accounts on my server
Claude: [calls cpanel_email_list_accounts] Found 12 email accounts on example.com...

You: Create a new MySQL database called "app_prod"
Claude: [calls cpanel_mysql_create_database] Database "app_prod" created successfully.

You: Add a CNAME record pointing blog to my main domain
Claude: [calls cpanel_dns_add_record] Added CNAME record: blog -> example.com

You: What's the server load?
Claude: [calls cpanel_whm_load_average] Load: 0.42, 0.38, 0.35 (1m, 5m, 15m)

为什么是这个?

cpanel mcp ringo380/cpanel mcp
工具计数 47 27
WHM管理工具 11(帐户、服务、套餐、服务器) 有限
API覆盖范围 UAPI+WHM API 1 仅限UAPI
语言 TypeScript,Python,Go TypeScript
电子邮件管理 完整的CRUD+货运代理+配额 基本
MySQL 完全CRUD+用户+权限 基本
安全套接层 列表+安装+CSR生成 否
备份 列表+创建 否

47种工具,涵盖UAPI和WHM的14个类别。第二大cPanel MCP有27个工具,没有WHM覆盖。

api参考

  • 通用应用程序接口 (端口2083):用户级操作——电子邮件、文件、数据库、SSL、DNS
  • WHM API 1 (端口2087):服务器管理员--帐户、服务、包、服务器信息
  • 认证: Authorization: cpanel USER:TOKEN (UAPI)或 whm root:TOKEN (WHM)

发展

cd typescript && npm install && npm run build
npx @modelcontextprotocol/inspector build/index.js

相关项目

许可证

麻省理工学院 -- 紫松鼠传媒