1Panel MCP Server

1Panel MCP Server 是为 1Panel 实现的 Model Context Protocol (MCP) 服务器。

安装

前提条件

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

从源代码构建（二进制）

1. 克隆仓库：

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

2. 构建项目：

   make build
   

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

使用 go install 安装

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

使用方法

你可以使用诸如 Cursor 和 Windsurf 这样的工具来使用 1Panel MCP Server。

stdio 模式

二进制

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

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

SSE 模式

以 SSE 模式启动 MCP 服务器：

mcp-1panel -host <your 1Panel access address> -token <your 1Panel access token> -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 交互的工具：