1Panel MCP Server

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": "<your 1Panel base URL>",
        "ONEPANEL_API_KEY": "<your 1Panel 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 工具：deploy_website

将网站部署到 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 Key 有效且权限充足
2. 确认网站目录存在且具有写入权限
3. 检查 1Panel 服务日志，获取更详细的错误信息
4. 如果文件上传失败，可能是文件权限或格式问题所致