1 Panel MCP

1面板MCP服务器

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

\[！重要\] 目前，该项目是一个实验项目，并不意味着它可以直接使用。

视频演示

特性

• 自动将网站部署到1Panel服务器
• 创建尚未存在的网站
• 将静态网站文件上传到1Panel
• 与MCP标准协议完全兼容

用法

在Cursor IDE中配置MCP

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

1. 打开的游标
2. 创建 .cursor/mcp.json

{
  "mcpServers": {
    "1panel-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "1panel-mcp"
      ],
      "env": {
        "ONEPANEL_BASE_URL": "",
        "ONEPANEL_API_KEY": "",
        "ONEPANEL_API_VERSION": "v2" // optional, default is v2
      }
    }
  }
}

使用MCP部署网站

在Cursor中，您可以在AI聊天中使用以下命令部署网站：

Deploy to 1Panel with domain=yourdomain.com

或者，您可以使用以下格式：

Deploy website to 1Panel server, domain: yourdomain.com

api参考

MCP工具：部署_网站

将网站部署到1Panel。

参数：

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

答复：

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

实现细节

部署程序

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

故障排除

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

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