1Panel MCP Server

Name: 1Panel MCP Server
Author: ruibaby

@ruibaby

Repository Homepage

About 1Panel MCP Server

A MCP server for automated website deployment to 1Panel (Experimental)

#mcp #website-deployment #automation

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "1panel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "1panel-mcp"
      ],
      "env": {
        "ONEPANEL_BASE_URL": "<your 1Panel base URL>",
        "ONEPANEL_API_KEY": "<your 1Panel API key>",
        "ONEPANEL_API_VERSION": "v2"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 1Panel MCP Server?

An experimental MCP (Model Context Protocol) server that automates static website deployment to 1Panel. It creates websites if they don’t exist, uploads files, and integrates with Cursor IDE via the MCP standard.

How to use 1Panel MCP Server?

Configure it in Cursor IDE by creating a .cursor/mcp.json file with the 1panel-mcp command (npx -y 1panel-mcp) and environment variables ONEPANEL_BASE_URL, ONEPANEL_API_KEY, and optionally ONEPANEL_API_VERSION. Then invoke the deploy_website tool inside Cursor’s AI chat with a domain (e.g., “Deploy to 1Panel with domain=yourdomain.com”).

Key features of 1Panel MCP Server

Automates website deployment to 1Panel servers.
Creates websites if they don’t already exist.
Uploads static website files to 1Panel.
Fully compatible with the MCP standard protocol.
Returns upload statistics (total, succeeded, failed files).
Designed to be used from Cursor IDE.

Use cases of 1Panel MCP Server

Deploying a static site from a Cursor project to a 1Panel server with one AI command.
Automating website creation and file upload without manual 1Panel UI steps.
Integrating MCP‑based workflows with 1Panel static website hosting.

FAQ from 1Panel MCP Server

Is this project production‑ready?

No. The README explicitly states that the project is experimental and does not mean it can be used directly.

What environment variables are required?

ONEPANEL_BASE_URL (your 1Panel base URL), ONEPANEL_API_KEY (your API key), and optionally ONEPANEL_API_VERSION (defaults to v2).

What parameters does the deploy_website tool accept?

domain (required) specifies the website domain. buildDir (optional) specifies the build directory path.

What should I do if deployment fails?

Check that your API key is valid and has sufficient permissions, verify the website directory exists and is writable, review 1Panel server logs, and ensure file permissions/formats are correct.

How do I configure this server in Cursor?

Create a .cursor/mcp.json file inside your project with the JSON configuration shown in the README, providing the command, args, and env fields.