[English] | [中文(简体)]

1Panel MCP 服务器

1Panel MCP Server是1Panel 的模型上下文协议 (MCP) 服务器的实现。

安装方法

方法一：从发布页面下载（推荐）

访问发布页面并下载与您的系统相对应的可执行文件。
安装示例（适用于 amd64）：

chmod +x mcp-1panel-linux-amd64
mv mcp-1panel-linux-amd64 /usr/local/bin/mcp-1panel

方法 2：从源代码构建

确保本地安装了 Go 1.23 或更高版本。然后运行：

克隆存储库：

git clone https://github.com/1Panel-dev/mcp-1panel.git
cd mcp-1panel

构建可执行文件：

make build

将 ./build/mcp-1panel 移动到系统 PATH 中包含的目录。

方法三：通过 go install 安装

确保本地安装了 Go 1.23 或更高版本。然后运行：

go install github.com/1Panel-dev/mcp-1panel@latest

方法四：通过Docker安装

确保 Docker 已在您的机器上正确安装和配置。

官方镜像支持以下架构：

amd64
arm64
臂/v7
s390x
ppc64le

Related MCP server: MCP Server

用法

1Panel MCP Server 支持两种运行模式： stdio和sse 。

stdio模式

使用本地二进制

在Cursor或者Windsurf的配置文件中添加：

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
        "PANEL_HOST": "such as http://localhost:8080"
      }
    }
  }
}

在 Docker 中运行

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "such as http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>"
      }
    }
  }
}

sse 模式

启动 MCP 服务器：

mcp-1panel -host http://localhost:8080 -token <your 1Panel access token> -transport sse -addr http://localhost:8000

在 Cursor 或 Windsurf 中配置：

{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

命令行选项

-token ：1Panel 访问令牌
-host : 1面板访问地址
-transport ：传输类型（stdio 或 sse，默认值：stdio）
-addr ：启动 SSE 服务器地址（默认值： http://localhost:8000 ）

可用工具

服务器提供了与 1Panel 交互的各种工具：

工具	类别	描述
获取仪表板信息	系统	列出仪表板状态
获取系统信息	系统	获取系统信息
列出网站	网站	列出所有网站
创建网站	网站	创建网站
列表_ssls	证书	列出所有证书
创建SSL	证书	创建证书
列出已安装的应用程序	应用	列出已安装的应用程序
安装_openresty	应用	安装 OpenResty
安装mysql	应用	安装 MySQL
列出数据库	数据库	列出所有数据库
创建数据库	数据库	创建数据库