mcp-1panel

Integrations

  • Provides tools for managing a 1Panel instance, including retrieving system information, managing websites, SSL certificates, applications, and databases. Enables actions like creating websites, installing applications like OpenResty and MySQL, and managing database resources.

  • Supports MySQL database operations, including listing existing databases, creating new databases, and installing MySQL instances via the 1Panel interface.

1Panel MCP Server

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

Installation

Prerequisites

  • Go 1.23.0 or higher
  • Existing 1Panel

Build from Source

  1. Clone the repository:
    git clone https://github.com/1Panel-dev/mcp-1panel.git cd mcp-1panel
  2. Build the project:
    make build
    Move ./build/mcp-1panel to the system environment path.

Install using go install

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

Usage

Cursor and Windsurf configuration example:

stdio mode

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

sse mode

start mcp server through sse

mcp-1panel -host <your 1Panel access address> -token <your 1Panel access token> -transport sse -addr "http://localhost:8000"
{ "mcpServers": { "mcp-1panel": { "url": "http://localhost:8000/sse" } } }

Command Line Options

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

Environment Variables

You can also configure the server using environment variables:

  • PANEL_HOST: 1Panel access address
  • PANEL_ACCESS_TOKEN: 1Panel access token

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 all installed applications
install_openrestyApplicationInstall OpenResty
install_mysqlApplicationInstall MySQL
list_databasesDatabaseList all databases
create_databaseDatabaseCreate a database
-
security - not tested
A
license - permissive license
-
quality - not tested

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

  1. Installation
    1. Prerequisites
    2. Build from Source
    3. Install using go install
  2. Usage
    1. stdio mode
    2. sse mode
    3. Command Line Options
    4. Environment Variables
  3. Available Tools