寶塔面板 MCP Server 安裝教學：讓 Claude、Cursor 直接查日誌和管理網站

如果你平时用 Claude、Cursor 或其他支持 MCP 的 AI 工具排查服务器问题，宝塔面板 MCP Server 的价值很直接：把宝塔里最常用的网站、日志和系统状态查询能力接到对话里，少走一层面板点点点。这篇文章基于 SuxyEE/bt-panel-mcp-server 公开仓库整理成中文教程，重点讲清安装、配置和风险边界，不照搬原文。

如果你还在搭自己的 AI 运维与开发工作流，也可以顺手看下 AI 輔助 WordPress 營運教學、Codex 接入第三方模型實踐、AI 開發分類頁 和 网站工具中心，把代码、内容和服务器排查串起来。

先说结论：这个项目最适合谁

截至 2026 年 7 月 22 日，仓库 README 和 package.json 显示这个项目名为 bt-panel-mcp-server，npm 版本为 0.1.0，运行环境要求 Node.js >= 18。它适合已经在用宝塔面板、又希望把日志查看、站点信息读取、系统状态查询接入 AI 助手的人。

更准确地说，它不是拿来替代宝塔面板本身，而是把常见操作变成自然语言入口。默认模式是只读，这一点很重要，因为这意味着你可以先把它当成安全的查询层，而不是一上来就给模型写权限。

仓库到底能做什么

官方 README 里列得很清楚：只读模式下可以列网站、查 Nginx 和应用日志、看系统状态、读文件、看站点配置和备份信息。如果把 BT_MODE 切到 full，才会额外开放建站、停站、绑域名、备份和写文件等动作。

这意味着它有两个很典型的使用场景：一是你先让 AI 帮你读日志和定位问题；二是你确认边界后，再让它执行明确的面板管理动作。第二类操作的风险更高，生产站建议单独做审批习惯。

第 1 步：先在宝塔后台开 API

仓库官方快速开始的第一步不是装 Node，而是先去宝塔面板打开 API 接口。你要记住三项信息：面板端口、安全入口路径、API 密钥。另外，README 明确要求把本机 IP 加入 API 白名单，否则请求会被拒绝。

BT_PANEL_URL 的拼法 也完全依赖这里的设置。比如你用了自定义端口和安全入口，那么最终地址就要写成 http://服务器IP:端口/安全入口 或 HTTPS 版本，不能只填一个裸 IP。

第 2 步：在 Claude、Cursor 或其他 MCP 客户端里配置

官方 README 给了两种方式：推荐 npx -y bt-panel-mcp-server，这样不需要你手动维护本地构建；如果你已经克隆源码，也可以直接用本地 dist/index.js 启动。对于大多数普通使用者，npx 方式更省事，也更方便后续跟版本。

配置时最核心的三个环境变量是：

• BT_PANEL_URL：宝塔面板地址，支持自定义端口、安全入口和 HTTPS。
• BT_API_KEY：宝塔 API 密钥。
• BT_MODE：readonly 或 full。

第 3 步：先用 readonly 跑通，再决定要不要 full

这一点我建议你不要跳。因为仓库本身就把默认模式设成 readonly，作者的意图很明确：先解决查询和排障，再决定是否开放写权限。如果你的主要诉求是“让 AI 帮我看宝塔上的日志、CPU、磁盘和站点配置”，其实 readonly 已经足够覆盖大半需求。

只有当你确定要让 AI 帮你做建站、绑定域名、停用测试站、写入 HTML 或保存 Nginx 配置时，才改成 full。哪怕切到 full，也建议先在测试站验证，不要直接拿生产站做第一轮实验。

第 4 步：首次验证建议怎么做

第一次连上以后，不要急着让它改站。最稳妥的顺序是：

1. 先让它列出所有网站，确认 API 通了。
2. 再让它读某个站点最近 100 到 200 行 Nginx 错误日志。
3. 接着看一次系统状态，确认 CPU、内存、磁盘字段都能返回。
4. 如果这些都正常，再考虑是否在测试站开启 full 模式。

实用检查清单

• 宝塔 API 已开启，且你的本机 IP 在白名单里。
• BT_PANEL_URL 带上了正确端口和安全入口。
• Node 版本不低于 18。
• 先用 npx 方式跑通配置，再考虑本地源码方式。
• 默认先用 readonly，不要一开始就给生产站 full 权限。
• 写配置、停站、改域名等操作先在测试站验证。

常见问题

参考资料

• SuxyEE/bt-panel-mcp-server GitHub 仓库
• 官方 README
• 官方 package.json
• npm 包页面
• Model Context Protocol 官方文档