🚀 1Panel MCP 服务端

1Panel MCP 服务端 是 1Panel 的模型上下文协议（MCP）服务器实现，为相关应用提供了重要的协议支持。

🚀 快速开始

✨ 主要特性

1Panel MCP 服务端支持 stdio 和 sse 两种运行模式，能满足不同场景下的使用需求。

📦 安装指南

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

1. 访问 发布页面，下载与您系统对应的可执行文件。
2. 示例安装（针对 amd64）：

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

方法 2：从源码构建

确保本地已安装 Go 1.23 或更高版本。然后按以下步骤操作：

1. 克隆仓库：

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

2. 构建可执行文件：

make build

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

方法 3：通过 go install 安装

确保本地已安装 Go 1.23 或更高版本，然后运行以下命令：

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

方法 4：通过 Docker 安装

确保 Docker 已正确安装并配置在您的机器上。官方镜像支持以下架构：

• amd64
• arm64
• arm/v7
• s390x
• ppc64le

💻 使用示例

基础用法

1Panel MCP 服务端支持两种运行模式：stdio 和 sse。下面以 stdio 模式为例进行说明。

使用本地二进制文件

在 Cursor 或 Windsurf 的配置文件中添加以下内容：

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

使用 Docker 运行

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e"
      ]
    }
  }
}