跳到主要内容
版本:latest

宝塔 MCP 介绍

MCP(Model Context Protocol,模型上下文协议)是一种用于连接 AI 应用与外部工具、数据和服务的开放协议。宝塔 MCP 服务通过标准化接口,将宝塔面板的运维能力接入支持 MCP 的 Agent,让用户可以在常用的 AI 工具中查询服务器状态并执行经过授权的面板操作。

宝塔 MCP 能做什么

完成安装和授权后,Agent 可以通过自然语言理解用户意图,再调用宝塔 MCP 服务完成对应的服务器运维任务。它适合以下场景:

  • 在支持 MCP 的 Agent 中查询服务器和服务状态
  • 辅助完成网站、数据库、防火墙等面板运维工作
  • 将宝塔面板能力接入已有的 AI 工作流
  • 减少在多个管理界面之间切换和手动编写命令

与宝塔 AI 助手的区别

对比项宝塔 AI 助手宝塔 MCP
使用入口宝塔面板内的 AI 功能支持 MCP 的外部 Agent
主要用途在面板内对话、诊断、分析和执行运维任务将宝塔面板能力提供给外部 Agent 调用
接入方式在面板中配置模型后使用安装 MCP 服务并配置服务地址、授权令牌和 IP 白名单
适用场景希望直接在宝塔面板中使用 AI希望在已有 Agent 或 AI 工作流中管理宝塔面板

两者可以并行使用:宝塔 AI 助手提供面板内的一体化 AI 运维体验,宝塔 MCP 则负责连接外部 Agent。

工作方式

宝塔 MCP 的接入流程包括:

  1. 在宝塔面板中安装【宝塔 MCP 服务】
  2. 配置 HTTPS、8765 端口和 Agent 的公网 IP 白名单
  3. 获取 MCP 服务器地址和授权令牌
  4. 在支持 MCP 的 Agent 中完成连接配置
  5. Agent 通过 MCP 服务调用经过授权的面板能力
安全说明

MCP 服务器地址和授权令牌属于敏感信息。生产环境应仅允许可信 IP 访问服务端口,并妥善保存授权令牌;如发现泄露,请立即重新生成授权信息。

下一步