使用说明
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
相关项目
- 普通mcp --比特币普通MCP服务器
- solana mcp服务器应用程序 --Solana钱包+DeFi MCP
- solmail mcp --通过Solana发送连锁邮件
