1Panel MCP Server

Name: 1Panel MCP Server
Author: ruibaby

@ruibaby

代码仓库主页

关于 1Panel MCP Server

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

#mcp #website-deployment #automation

基本信息

分类

其他

许可证

MIT

运行时

node

传输方式

stdio

发布者

ruibaby

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "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"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.