mcp-1panel

1Panel MCP Server (mcp-1panel) implements the Model Context Protocol for managing and interacting with 1Panel through a dedicated MCP server. It supports two operating modes: stdio and SSE. In stdio mode, it can be run as a local binary or inside a container, reading configuration from the MCP hosting tool (Cursor/Windsurf) and using environment variables to connect to your 1Panel instance. In sse mode, the server exposes an SSE endpoint that clients can subscribe to for real-time MCP updates. The server exposes a set of tools for managing dashboards, websites, databases, certificates, and apps within 1Panel, such as listing system info, listing websites, creating websites, and installing OpenResty or MySQL. The tools are grouped by category (System, Website, Certificate, Application, Database) and can be invoked through the MCP host or by the provided CLI options when running in SSE mode.

Prerequisites:

• Go 1.23+ (for source builds or go install)
• Docker (optional for docker-based deployment)
• A recent release binary if you prefer the prebuilt executable

Installation options:

1. Download from Release Page (Recommended)

• Go to the Releases Page and download the executable for your system.
• Make it executable and move it to a directory in your PATH: chmod +x mcp-1panel-linux-amd64 mv mcp-1panel-linux-amd64 /usr/local/bin/mcp-1panel

2. Build from Source

• Ensure Go 1.23+ is installed.
• Clone the repository and build: git clone https://github.com/1Panel-dev/mcp-1panel.git cd mcp-1panel make build
• Move the built binary to PATH if needed: mv ./build/mcp-1panel /usr/local/bin/mcp-1panel

3. Install via go install

• Ensure Go 1.23+ is installed.
• Run: go install github.com/1Panel-dev/mcp-1panel@latest

4. Install via Docker

• Ensure Docker is installed.
• Run the official image supporting architectures: amd64, arm64, arm/v7, s390x, ppc64le
• Example (adjust as needed): docker run -it --rm
  -e PANEL_HOST=http://localhost:8080
  -e PANEL_ACCESS_TOKEN=<your token>
  1panel/1panel-mcp-server

Prerequisites summary:

• Access to a 1Panel instance with a valid token
• Appropriate environment configuration for host and token
• Chosen deployment method (binary, source, or Docker)

Environment variables PANEL_HOST and PANEL_ACCESS_TOKEN are required when using stdio or Docker-based setups. In SSE mode, you can customize the host/token via CLI options when starting mcp-1panel. If you encounter connection issues, verify that the PANEL_HOST URL is reachable from the MCP host and that the access token has sufficient permissions in 1Panel. When using Docker, ensure the container has network access to the 1Panel host and that the environment variables are passed correctly. The server exposes tools across System, Website, Certificate, Application, and Database categories; consult the Available Tools table in the repository to understand each tool's purpose and required parameters.