1panel MCP

🚀 1Panel MCP Server

A Model Context Protocol (MCP) server for automatically deploying websites to 1Panel.

⚠️ Important Note

Currently, this project is still in the experimental stage and is not ready for direct production use.

🎥 Video Demonstration

https://www.bilibili.com/video/BV1SjQRY3EmM/

✨ Features

• Automatically deploy websites to 1Panel servers
• Create websites that do not exist
• Upload static website files to 1Panel
• Fully compatible with the MCP standard protocol

💻 Usage Examples

Configure MCP in Cursor IDE

To use this server with Cursor IDE, add the following MCP configuration:

1. Open Cursor.
2. Create a .cursor/mcp.json file.

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

Deploy a Website Using MCP

In Cursor, you can deploy a website in the AI chat window with the following command:

Deploy the website to 1Panel with the domain name yourdomain.com

Or use the following format:

Deploy the website to the 1Panel server. Domain name: yourdomain.com

📚 Documentation

MCP Tool: deploy_website

Deploy a website to 1Panel.

Parameters:

• domain (Required): The domain name of the website.
• buildDir (Optional): The path to the build directory.

Response:

Successfully deployed to 1Panel!
Domain: yourdomain.com
URL: http://yourdomain.com
Upload statistics:
- Total files: 25
- Successfully uploaded: 25
- Failed to upload: 0

🔧 Technical Details

Deployment Process

1. Check the Build Directory: Verify the existence of the specified build directory.
2. Website Creation: Create a new static website via the 1Panel API if it does not exist.
3. File Upload: Upload all files from the build directory to the website.
4. Statistics: Return detailed statistics about the upload process.

🛠️ Troubleshooting

If you encounter issues during the deployment process, check the following:

1. Ensure that your API key is valid and has sufficient permissions.
2. Verify that the website directory exists and has write permissions.
3. Check the 1Panel server logs for more detailed error information.
4. If file upload fails, it may be due to file permissions or format issues.