1Panel MCP 服务器

这是一个用于自动将网站部署到1Panel的模型上下文协议（MCP）服务器。

[!重要] 目前，该项目仍处于实验阶段，并不意味着可以直接使用。

视频演示

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

特性

• 自动将网站部署到1Panel服务器
• 如果网站不存在，则创建新网站
• 将静态网站文件上传到1Panel
• 完全兼容MCP标准协议

使用方法

在Cursor IDE中配置MCP

要使用此服务器与Cursor IDE，请添加以下MCP配置：

1. 打开Cursor
2. 创建.cursor/mcp.json

{
  "mcpServers": {
    "1panel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "1panel-mcp"
      ],
      "env": {
        "ONEPANEL_BASE_URL": "<你的1Panel基础URL>",
        "ONEPANEL_API_KEY": "<你的1Panel API密钥>",
        "ONEPANEL_API_VERSION": "v2" // 可选，默认为v2
      }
    }
  }
}

使用MCP部署网站

在Cursor中，你可以通过AI聊天中的以下命令来部署网站：

将网站部署到1Panel，域名=yourdomain.com

或者你可以使用以下格式：

将网站部署到1Panel服务器，域名：yourdomain.com

API参考

MCP工具：deploy_website

将网站部署到1Panel。

参数：

• domain（必需）：网站域名
• buildDir（可选）：构建目录路径

响应：

成功部署到1Panel！
域名：yourdomain.com
网址：http://yourdomain.com
上传统计：
- 总文件数：25
- 成功上传：25
- 上传失败：0

实现细节

部署过程

1. 检查构建目录：验证指定的构建目录是否存在
2. 创建网站：如果网站不存在，则通过1Panel API创建新的静态网站
3. 文件上传：从构建目录上传所有文件到网站
4. 统计信息：返回关于上传过程的详细统计信息

故障排除

如果你遇到部署问题，请检查以下内容：

1. 确保你的API密钥有效且具有足够的权限
2. 验证网站目录存在并且具有写入权限
3. 检查1Panel服务器日志以获取更详细的错误信息
4. 如果文件上传失败，可能是由于文件权限或格式问题