🚀 1Panel MCP 服务器
1Panel MCP 服务器是一个基于 模型上下文协议 (MCP) 的服务器，可实现将网站自动化部署到 1Panel 平台，为网站部署提供了高效、便捷的解决方案。
⚠️ 重要提示
目前该项目是一个实验性项目，并不意味着可以直接使用。
🚀 快速开始
你可以通过观看下方的视频演示，快速了解 1Panel MCP 服务器的使用方法。 https://www.bilibili.com/video/BV1SjQRY3EmM/
✨ 主要特性
- 自动将网站部署到 1Panel 服务器
- 若网站不存在，则自动创建新网站
- 支持上传静态网站文件到 1Panel
- 完全兼容 MCP 标准协议
📦 安装指南
此部分文档未提及具体安装步骤，暂不提供相关内容。
💻 使用示例
基础用法
在 Cursor IDE 中配置 MCP
要使用此服务器与 Cursor IDE，需添加以下 MCP 配置：
{
"mcpServers": {
"1panel-mcp": {
"command": "npx",
"args": [
"-y",
"1panel-mcp"
],
"env": {
"ONEPANEL_BASE_URL": "" ,
"ONEPANEL_API_KEY": ""
}
}
}
}
操作步骤如下：
- 打开 Cursor
- 创建
.cursor/mcp.json
使用 MCP 部署网站
在 Cursor 中，您可以使用以下命令通过 AI 聊天部署网站：
将网站部署到 1Panel，域名为 yourdomain.com
或者使用以下格式：
部署到 1Panel 服务器，域名：yourdomain.com
高级用法
此部分文档未提及高级用法相关内容，暂不提供相关内容。
📚 详细文档
API 参考
MCP 工具：deploy_website
将网站部署到 1Panel。
参数：
domain（必需）：网站域名buildDir（可选）：构建目录路径
响应：
成功部署到 1Panel！
域名：yourdomain.com
URL：http://yourdomain.com
上传统计信息：
- 总文件数：25
- 成功上传：25
- 失败上传：0
🔧 技术细节
部署流程
- 检查构建目录：验证指定的构建目录是否存在
- 网站创建：如果网站不存在，则通过 1Panel API 创建新静态网站
- 文件上传：从构建目录上传所有文件到网站
- 统计信息：返回有关上传过程的详细统计数据
💡 使用建议
如果您在部署时遇到问题，请检查以下内容：
- 确保您的 API Key 有效且具有足够的权限
- 验证网站目录存在且有写入权限
- 检查 1Panel 服务器日志以获取更详细的错误信息
- 如果文件上传失败，可能是由于文件权限或格式问题
📄 许可证
此部分文档未提及许可证相关信息，暂不提供相关内容。