宝塔面板MCP-wzz
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"bt-panel-mcp": {
"args": [
"bt-panel-mcp-server",
"--mode",
"readonly"
],
"command": "npx",
"env": {
"BT_API_KEY": "用户自己填",
"BT_PANEL_URL": "https://你的面板:8765"
}
}
}
}
该服务需要配置环境变量:BT_API_KEY、BT_PANEL_URL
Streamable HTTP 传输配置
{
"mcpServers": {
"bt-panel-mcp": {
"args": [
"bt-panel-mcp-server",
"--mode",
"readonly"
],
"command": "npx",
"headers": {
"Authorization": "MCP API密钥"
},
"url": "https://你的面板:8765"
}
}
}
可用工具 (11 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
list_sites 1 个参数
列出宝塔面板中所有托管的网站,包括域名、根目录、运行状态。查询日志前先用此工具确认网站名称和路径。
该工具无需必填参数,直接调用即可
get_nginx_logs 4 个参数 需填 1 项
【Nginx 层日志 — HTTP 请求记录】读取 Nginx 的访问日志(access)或错误日志(error)。记录的是每一条 HTTP 请求:IP、时间、URL、状态码(200/404/499/502)、响应大小、来源页面、UserAgent。适合排查:HTTP 状态码异常、流量来源分析、爬虫/攻击识别、Nginx 配置问题、静态资源 404 等。注意:此工具【不包含】任何业务逻辑、数据库、接口报错等应用层信息。工具会自动在 /www/wwwlogs/ 目录探测日志路径,无需手动填写。
必填参数:site_name
get_app_logs 4 个参数
【应用层日志 — 业务/程序运行记录】读取后端应用程序自身输出的业务日志。记录的是代码运行过程中的 INFO/WARN/ERROR 信息:SQL 报错、接口异常、业务逻辑错误、堆栈跟踪等。适合排查:业务逻辑 Bug、数据库异常、第三方接口报错、程序崩溃、性能慢查询等。注意:此工具【不包含】HTTP 请求记录,那些属于 Nginx 层,应使用 get_nginx_logs。支持框架:Laravel、ThinkPHP、Java、Node.js,默认 auto 自动探测所有常见路径。
该工具无需必填参数,直接调用即可
get_panel_logs 1 个参数
读取宝塔面板自身的操作日志,包括登录记录、配置变更、安装/卸载软件等操作历史。适合审计谁在什么时候操作了面板。
该工具无需必填参数,直接调用即可
get_system_status
获取服务器实时状态:CPU 使用率、内存占用、磁盘分区使用情况、网络实时流量、系统负载。适合排查性能问题或确认服务器资源是否充足。
该工具无需必填参数,直接调用即可
read_file 2 个参数 需填 1 项
读取服务器上任意文件内容(只读)。适合查看 Nginx 配置文件、PHP 配置、应用配置文件、自定义日志路径等。建议配合 last_lines 参数避免读取超大文件。
必填参数:path
get_nginx_config 3 个参数 需填 2 项
读取指定网站的 Nginx 配置文件(/www/server/panel/vhost/nginx/<域名>.conf)。适合查看反代、SSL、location 规则等配置。只读,不修改。
必填参数:action、site_name
list_domains 4 个参数 需填 2 项
查询网站绑定的所有域名列表,包括域名、端口、添加时间。
必填参数:action、site_name
list_backups 3 个参数 需填 2 项
查询网站的备份列表,包括备份 ID、文件名、创建时间。
必填参数:action、site_name
search_bt_api 4 个参数
搜索当前内置的宝塔官方 API 目录。返回操作 ID、HTTP 路由、必填参数和模块统计;所有模式可用。
该工具无需必填参数,直接调用即可
get_bt_api_operation 1 个参数 需填 1 项
获取一个官方宝塔 API 操作的完整参数定义。先用 search_bt_api 找到操作 ID。所有模式可用。
必填参数:operation
服务介绍
宝塔面板MCP-wzz