MCP server for working with 1Panel — a web-based Linux server management tool. Enables management of websites, databases, applications, and system resources through natural language.

Installation

Download from Release

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

Build from Source

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

Go Install

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

Docker

docker run -i --rm -e PANEL_HOST -e PANEL_ACCESS_TOKEN 1panel/1panel-mcp-server

Configuration

Cursor/Windsurf — Local Binary

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

Cursor/Windsurf — 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>"
      }
    }
  }
}

Cursor/Windsurf — SSE Mode

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

Available Tools

Tool	Description
`get_dashboard_info`	Get dashboard status
`get_system_info`	Get system information
`list_websites`	List all websites
`create_website`	Create a website
`list_ssls`	List all certificates
`create_ssl`	Create a certificate
`list_installed_apps`	List installed applications
`install_openresty`	Install OpenResty
`install_mysql`	Install MySQL
`list_databases`	List all databases
`create_database`	Create a database

Features

Support for stdio and SSE transport modes
Multi-architecture Docker support (amd64, arm64, arm/v7, s390x, ppc64le)
Website management
SSL certificate management
Database creation and viewing
Application installation and management
System monitoring and dashboard information
Integration with 1Panel management interface

Environment Variables

Required

PANEL_ACCESS_TOKEN — 1Panel access token for authentication
PANEL_HOST — 1Panel server address (e.g., http://localhost:8080)

Notes

Building from source requires Go 1.23 or higher. The server can be started in SSE mode with the command: mcp-1panel -host http://localhost:8080 -token -transport sse -addr http://localhost:8000

1Panel MCP Server