mcp-1panel

MCP.Pizza Chef: 1Panel-dev

Eleven tools sit on top of a 1Panel installation you already run: check the dashboard and machine details, list and create websites, list and issue security certificates, list installed applications, install MySQL or OpenResty, and list or create databases. There is no tool that deletes or uninstalls anything. Site creation is narrower than it sounds: it always uses port 80 with encryption off, in the default group, and only for plain or forwarding sites.

Coding

Data

Use This MCP server To

Check how my server is doing right now See which websites are running on my server Set up a plain site for a domain I just bought Get a security certificate issued for one of my domains List the applications and databases already installed Install MySQL without opening the control panel

README

1Panel MCP Server

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

Installation

Prerequisites

Go 1.25.0 or higher
Existing 1Panel

Build from Source

Clone the repository:

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

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

mcp-1panel FAQ

Do I need a paid key?

No. You generate an access token inside your own 1Panel settings and give it the address of your panel. Nothing to buy.

Do I need 1Panel already running?

Yes. This is a companion to an existing 1Panel installation on a server you control. On its own it does nothing.

Can I use this to launch a new website?

Yes, but only a basic one. It creates plain or forwarding sites on port 80 with encryption switched off and always in the default group. A custom port, HTTPS from the start, or a WordPress-style install still means opening the panel yourself.

Can it delete or break things?

It has no delete or uninstall tools whatsoever, so nothing existing can be removed through it. It can still create sites, databases, certificates, and installed software, which take up space and can collide with what is already there.

Why does certificate creation fail for me?

It needs a certificate-issuing account already configured inside 1Panel, and it silently picks the first one on the list. If you have none, or want a specific one, it cannot help.

Which apps does it work in?

Cursor and Windsurf are the documented ones, and it works in any assistant that reads a config file. There is also a networked mode for remote setups.

How hard is setup?

This one is for technical users. You install a small program written in Go, either building it or fetching it with a developer command, then add your panel address and token.

Is it safe to run over a network?

By default the networked modes demand a token and only listen on the machine itself. The settings let you disable both protections, which would put your server controls within reach of anyone who can see that address.