MCP 服务器

mcp-1panel

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

README

1Panel MCP 服务器

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

安装

前提条件

Go 1.23.0 或更高版本（用于二进制文件使用）
Docker（用于 Docker 使用）
已安装的 1Panel

从源代码构建（二进制文件）

克隆存储库：

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

构建项目：
```
make build
```
将 ./build/mcp-1panel 移动到系统 PATH 中包含的目录。

使用 `go install` 安装

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

用法

您可以将 1Panel MCP 服务器与 Cursor 和 Windsurf 等工具一起使用。

stdio 模式

二进制文件

确保已安装 Go 并且已构建或安装二进制文件：

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "<您的 1Panel 访问令牌>",
        "PANEL_HOST": "例如 http://localhost:8080"
      }
    }
  }
}

Docker

确保已安装 Docker：

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "例如 http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<您的 1Panel 访问令牌>"
      }
    }
  }
}

SSE 模式

使用 SSE 启动 MCP 服务器：

mcp-1panel -host <您的 1Panel 访问地址> -token <您的 1Panel 访问令牌> -transport sse -addr "http://localhost:8000"

Cursor/Windsurf 配置：

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

命令行选项

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

环境变量

您还可以使用环境变量配置服务器：

PANEL_HOST: 1Panel 访问地址
PANEL_ACCESS_TOKEN: 1Panel 访问令牌

可用工具

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

工具	类别	描述
get_dashboard_info	系统	列出仪表板状态
get_system_info	系统	获取系统信息
list_websites	网站	列出所有网站
create_website	网站	创建一个网站
list_ssls	证书	列出所有证书
create_ssl	证书	创建一个证书
list_installed_apps	应用	列出所有已安装的应用程序
install_openresty	应用	安装 OpenResty
install_mysql	应用	安装 MySQL
list_databases	数据库	列出所有数据库
create_database	数据库	创建一个数据库