1panel MCP

🚀 1Panel MCP 服務器

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>"
      }
    }
  }
}

使用 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

🔧 技術細節

部署流程

1. 檢查構建目錄：驗證指定的構建目錄是否存在。
2. 網站創建：通過 1Panel API 創建新的靜態網站（如果不存在）。
3. 文件上傳：從構建目錄上傳所有文件到網站。
4. 統計信息：返回有關上傳過程的詳細統計數據。

💡 使用建議

如果您在部署過程中遇到問題，請檢查以下內容：

1. 確保您的 API 密鑰有效且具有足夠的權限。
2. 驗證網站目錄存在且有寫入權限。
3. 檢查 1Panel 服務器日誌以獲取更詳細的錯誤信息。
4. 如果文件上傳失敗，可能是由於文件權限或格式問題。