1panel

🚀 1Panel MCP 服務器

1Panel MCP 服務器 是 1Panel 的 Model Context Protocol (MCP) 服務器實現，為相關係統提供了重要的協議支持。

🚀 快速開始

✨ 主要特性

• 支持多種安裝方式，包括從發佈頁面下載、從源碼構建、通過 go install 安裝以及通過 Docker 安裝。
• 提供 stdio 和 sse 兩種運行模式，滿足不同場景需求。
• 配備多個實用工具，方便管理和監控 MCP 服務器。

📦 安裝指南

方法一：從發佈頁面下載（推薦）

1. 訪問 發佈頁面，下載適用於您系統的可執行文件。
2. 示例安裝（針對 amd64）：

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

方法二：從源碼構建

確保本地已安裝 Go 1.23 或更高版本。然後按以下步驟操作：

1. 克隆倉庫：

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

2. 構建可執行文件：

make build

將 ./build/mcp-1panel 移動到系統 PATH 包含的目錄中。

方法三：通過 go install 安裝

確保本地已安裝 Go 1.23 或更高版本，然後運行：

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

方法四：通過 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": "<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 模式

1. 啟動 MCP 服務器：

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

2. 在 Cursor 或 Windsurf 中配置：

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

高級用法

以下是命令行選項說明：

• -token: 1Panel 訪問令牌
• -host: 默認監聽地址
• -transport: 支持的傳輸類型（默認為 http）
• -addr: 監聽地址和端口
• -loglevel: 日誌級別
• -version: 顯示版本信息

📚 詳細文檔

可用工具

MCP 服務器提供了以下工具：

這些工具可以幫助您更好地管理和監控 MCP 服務器。