BT Panel MCP Server

怎么用

在面板开启 API 并白名单运行主机 IP，客户端里用 npx -y bt-panel-mcp-server 启动，填好面板地址、API 密钥与模式，先跑一次只读检查，再按需切到 full。

核心用法

先在你的宝塔面板里把 API 接口打开、拿到密钥，并把这台跑 AI 的机器 IP 加进白名单，然后告诉 AI 你的面板地址和密钥。日常就是直接问它：某个网站为什么打不开、磁盘被谁占满了、昨天的错误日志里有什么。它默认只查不改，你想让它建站、备份、改配置，需要主动切到完整模式并重启一次客户端。

触发场景

网站突然打不开或者报 502，想让 AI 直接去服务器上看看到底哪一步出问题了,服务器 CPU 或内存飙高、磁盘快满了，想让它帮我查是哪个站点、哪个进程在吃资源,想翻某个站点的访问日志或错误日志，但不想自己登面板一层层点进去找,手上管着好几台服务器，想每周让 AI 帮忙统一巡检一遍，出个状态小结,想让 AI 顺手帮我在面板上建个站点、加个数据库或配个 SSL，但怕它乱删东西,宝塔面板功能太多，想干一件事却不知道对应哪个操作，想让 AI 先帮我查清楚再执行

优劣特点

好处是覆盖面很广，系统、网站、数据库、文件、计划任务、SSL、Docker 这些常见操作基本都能通过 AI 触发，而且默认只读，先看不动，心里踏实。限制也很实在：默认状态下它改不了任何东西，想写入必须手动切到完整模式并重启客户端；而且能不能真的执行成功，取决于你的面板版本、装了哪些插件、账号权限够不够。完整模式下包含删除、重启、升级这类高风险动作，生产环境务必先备份再让它动手。

适用人群

适合自己管着宝塔面板、又常用 AI 助手的人，尤其是懒得在面板里一层层点、想用一句话问出服务器状况的站长和小团队运维。不适合完全不懂服务器、也没有备份习惯的人，因为一旦放开完整模式，AI 的操作是真实生效的。

详细说明

宝塔面板 MCP 服务器。默认只读，先能用对话看站点、日志、文件与服务器负载；需要写入和管理时再显式开启完整模式。

常见问题

它是做什么的？

站点打不开时，还在登录宝塔面板翻日志、手动查负载？装个插件服务，用对话就能查站点和日志。

支持哪些工具？

这个MCP可以装进 Claude Code、Codex、Cursor。

怎么用？

在面板开启 API 并白名单运行主机 IP，客户端里用 npx -y bt-panel-mcp-server 启动，填好面板地址、API 密钥与模式，先跑一次只读检查，再按需切到 full。

源码在哪里？

源码地址：https://github.com/SuxyEE/bt-panel-mcp-server

怎么安装？

客户端的 MCP 市场走 ModelScope 注册中心，和这里的目录不是同一份 —— 点过去会打开 MCP 市场，需要你在那边搜一下这个名字。