1Panel MCP 服务器

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

[!IMPORTANT] 目前，这个项目是一个实验性项目，并不意味着它可以直接使用。

视频演示

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

功能

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

安装

# 克隆仓库
git clone https://github.com/yourusername/1panel-mcp-server.git
cd 1panel-mcp-server

# 安装依赖
npm install
# 或者如果你使用 pnpm
pnpm install

# 配置环境变量
cp .env.example .env

编辑 .env 文件，填入你的 1Panel 服务器信息：

PORT=3000
ONEPANEL_BASE_URL=http://your-1panel-ip:port/api/v1
ONEPANEL_API_KEY=your_api_key
ONEPANEL_LANGUAGE=zh  # 语言选项：zh (中文) 或 en (英文)

使用方法

启动服务器

# 启动服务器
npm start

# 用于开发，带有自动重新加载
npm run dev

在 Cursor IDE 中配置 MCP

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

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

{
  "mcpServers": {
    "Deploy to 1Panel": {
      "url": "http://localhost:3000/sse"
    }
  }
}

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