JinDaGe - ezbt-mcp MCP Details

article

README

🚀 EZBT-MCP

EZBT-MCP 是一款基于 Model Context Protocol (MCP) 协议开发的宝塔面板 (BT Panel) 智能管理工具。它能让 AI 编辑器（像 Trae、Cursor 等）通过自然语言直接对宝塔面板服务器进行管理和操作，极大提升了管理效率。

🚀 快速开始

EZBT-MCP 允许 AI 编辑器借助自然语言管理宝塔面板服务器。你只需在 AI 编辑器中下达指令，就能完成服务器的各项管理操作。

✨ 主要特性

文件系统管理：支持文件的读取、保存、创建、删除以及权限修改（chmod/chown）。
网站自动化：一键查询网站列表、快速创建新的 PHP 网站。
数据库操作：实时获取 MySQL 数据库列表及信息。
Docker 集成：管理容器生命周期，查看容器详情及本地镜像列表。
邮件服务：支持邮箱账户的创建与邮件列表查询。
系统监控：实时获取服务器 CPU、内存、磁盘及网络状态。

📦 安装指南

环境要求

Go 1.18 或更高版本
已开启 API 接口的宝塔面板

1. 自动安装（推荐方案）

将下列文案全部复制发送给您的 IDE/文本编辑器：

请你阅读 https://github.com/XiaoLuoTian189/ezbt-mcp 帮我将这个MCP安装好

2. 编译步骤（手动安装）

克隆仓库：

git clone https://github.com/XiaoLuoTian189/ezbt-mcp.git
cd ezbt-mcp

编译可执行文件：

go build -o build/mcp-ezbt.exe main.go

📚 详细文档

配置说明

在 AI 编辑器（以 Trae/Cursor 为例）的 MCP 设置中添加以下配置：

{
  "mcpServers": {
    "ezbt": {
      "command": "C:\\你的路径\\ezbt-mcp\\build\\mcp-ezbt.exe",
      "env": {
        "BT_BASE_URL": "http://你的面板地址:8888",
        "BT_API_TOKEN": "你的宝塔API密钥"
      }
    }
  }
}

⚠️ 重要提示

请确保在宝塔面板后台将你运行 AI 编辑器的 IP 加入到 API 接口的白名单中，如果您的电脑没有固定的公网 IP，请您在 IP 白名单填写 * ，但是这将是危险的，请你务必注意在使用完毕后关闭 API！

💻 使用示例

你可以直接对 AI 说出目前工具支持的功能，并且它会在适当的时候被泛调用！

📄 许可证

本项目采用 MIT License 开源。

ezbt-mcp