MCP HubMCP Hub
1Panel-dev

mcp-1panel

by: 1Panel-dev

mcp-1panel is the Model Context Protocol (MCP) server implementation for 1Panel.

85created 18/03/2025
Visit
protocol
implementation

📌Overview

Purpose: The framework serves as an implementation of the Model Context Protocol (MCP) server for 1Panel, enabling efficient management and interaction with 1Panel features.

Overview: 1Panel MCP Server provides a streamlined interface for managing various aspects of the 1Panel ecosystem. Built to facilitate the integration of the Model Context Protocol, it enhances the operational capacity of 1Panel by offering tools for system management, website, certificate, application, and database handling.

Key Features:

  • Multi-transport capabilities: Supports both standard input/output (stdio) and server-sent events (sse) modes, providing flexibility in communication methods.

  • Extensive toolset: Includes commands for monitoring dashboard status, managing websites, creating SSL certificates, and handling database operations, allowing users to perform a wide array of administrative tasks seamlessly.


1Panel MCP Server

1Panel MCP Server is an implementation of the Model Context Protocol (MCP) server for 1Panel.

Installation Methods

Method 1: Download from Release Page (Recommended)

  1. Visit the Releases Page and download the executable file corresponding to your system.

  2. Example installation (for amd64):

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

Method 2: Build from Source

Make sure Go 1.23 or later is installed locally. Then run:

  1. Clone the repository:
git clone https://github.com/1Panel-dev/mcp-1panel.git
cd mcp-1panel
  1. Build the executable:
make build

Move ./build/mcp-1panel to a directory included in your system's PATH.

Method 3: Install via go install

Make sure Go 1.23 or later is installed locally. Then run:

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

Method 4: Install via Docker

Make sure Docker is correctly installed and configured on your machine.

The official image supports the following architectures:

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

Usage

1Panel MCP Server supports two running modes: stdio and sse.

stdio Mode

Using Local Binary

In the configuration file of Cursor or Windsurf, add:

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

Running in 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 Mode

  1. Start the MCP Server:
mcp-1panel -host http://localhost:8080 -token <your 1Panel access token> -transport sse -addr http://localhost:8000
  1. Configure in Cursor or Windsurf:
{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Command Line Options

  • -token: 1Panel access token
  • -host: 1Panel service address
  • -transport: Transport type (stdio or sse, default: stdio)
  • -addr: Start SSE server address (default: http://localhost:8000)

Available Tools

The server provides various tools for interacting with 1Panel:

ToolCategoryDescription
get_dashboard_infoSystemList dashboard status
get_system_infoSystemGet system information
list_websitesWebsiteList all websites
create_websiteWebsiteCreate a website
list_sslsCertificateList all certificates
create_sslCertificateCreate a certificate
list_installed_appsApplicationList installed apps
install_openrestyApplicationInstall OpenResty
install_mysqlApplicationInstall MySQL
list_databasesDatabaseList all databases
create_databaseDatabaseCreate a database