1Panel MCP server

The 1Panel MCP Server is an implementation of the Model Context Protocol server that allows you to interact with 1Panel through compatible clients like Cursor or Windsurf, enabling AI-assisted management of your 1Panel installations.

Installation

Download from Release Page

This is the recommended installation method:

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

2. Install the executable (example for amd64):

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

Build from Source

If you prefer to build from source:

1. Ensure Go 1.23 or later is installed
2. Clone and build the repository:

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

3. Move the executable to your PATH:

mv ./build/mcp-1panel /usr/local/bin/

Install via Go

If you have Go installed:

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

Install via Docker

The official Docker image supports multiple architectures (amd64, arm64, arm/v7, s390x, ppc64le):

docker pull 1panel/1panel-mcp-server

Usage

The MCP Server supports two running modes: stdio and sse.

Using stdio Mode

With Local Binary

Configure your MCP client (Cursor or Windsurf) with:

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

With Docker

Configure your MCP client with:

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>"
      }
    }
  }
}

Using sse Mode

1. Start the MCP Server:

mcp-1panel -host http://localhost:8080 -token <your 1Panel access token> -transport sse -addr http://localhost:8000

2. Configure in your MCP client:

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

Command Line Options

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

Available Tools

The server provides tools for interacting with 1Panel across different categories:

System Tools

• get_dashboard_info: List dashboard status
• get_system_info: Get system information

Website Management

• list_websites: List all websites
• create_website: Create a website

Certificate Management

• list_ssls: List all certificates
• create_ssl: Create a certificate

Application Management

• list_installed_apps: List installed apps
• install_openresty: Install OpenResty
• install_mysql: Install MySQL

Database Management

• list_databases: List all databases
• create_database: Create a database

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

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

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect