Tích hợp Máy chủ MCP 1Panel

Máy chủ MCP “1Panel” làm được gì?

Máy chủ MCP 1Panel là một triển khai của Máy chủ Model Context Protocol (MCP) được thiết kế riêng để tích hợp với 1Panel. Nó đóng vai trò cầu nối giữa trợ lý AI và nền tảng 1Panel, giúp nâng cao quy trình phát triển nhờ cho phép tác nhân AI tương tác lập trình với API và nguồn dữ liệu của 1Panel. Khi triển khai máy chủ này, lập trình viên có thể sử dụng các công cụ AI để tự động hóa và đơn giản hóa các tác vụ quản trị, vận hành phổ biến trong môi trường 1Panel, như truy vấn trạng thái hệ thống, quản lý file hoặc thực thi lệnh điều khiển. Máy chủ hỗ trợ nhiều phương thức truyền tải (stdio và sse), linh hoạt cho tích hợp ở nhiều môi trường khác nhau và có thể cấu hình an toàn với token API cùng địa chỉ máy chủ.

Danh sách Prompt

Không có mẫu prompt nào được đề cập trong tài liệu hoặc mã nguồn hiện có.

Danh sách Resource

Không có resource MCP rõ ràng nào được mô tả trong tài liệu hoặc mã nguồn hiện có.

Danh sách Công cụ

Không có công cụ cụ thể nào được liệt kê hoặc mô tả trong tài liệu hoặc mã nguồn hiện có (ví dụ: server.py không tồn tại trong dự án dựa trên Go này).

Các trường hợp sử dụng Máy chủ MCP này

• Tự động hóa 1Panel: Tích hợp trợ lý AI để tự động hóa các tác vụ quản trị 1Panel như khởi động lại dịch vụ, quản lý người dùng hoặc kiểm tra trạng thái qua lệnh AI chuẩn hóa.
• Vận hành từ xa: Cho phép script hoặc quy trình điều khiển AI tương tác với máy chủ 1Panel từ xa, nâng cao năng lực DevOps và quản trị hệ thống.
• Tích hợp AI truyền phát/SSE: Kích hoạt tương tác thời gian thực giữa 1Panel và tác nhân AI qua chế độ truyền tải SSE, cho phép giám sát trực tiếp và phản hồi nhanh.
• Truy cập lập trình an toàn: Sử dụng token truy cập và cấu hình dựa trên biến môi trường để chỉ cấp quyền cần thiết cho tác nhân AI với 1Panel, đảm bảo an toàn vận hành.

Hướng dẫn thiết lập

Windsurf

1. Đảm bảo bạn đã có file nhị phân hoặc Docker image của Máy chủ MCP 1Panel.

2. Lấy token truy cập 1Panel và URL máy chủ.

3. Chỉnh sửa file cấu hình Windsurf.

4. Thêm đoạn JSON sau vào dưới mcpServers:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<token truy cập 1Panel của bạn>",
           "PANEL_HOST": "ví dụ http://localhost:8080"
         }
       }
     }
   }
   

5. Lưu và khởi động lại Windsurf, sau đó kiểm tra kết nối máy chủ.

Ví dụ Docker

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "ví dụ http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<token truy cập 1Panel của bạn>"
      }
    }
  }
}

Claude

1. Tải về hoặc build Máy chủ MCP 1Panel.
2. Lấy token API 1Panel và thông tin host.
3. Mở file cấu hình của Claude.
4. Thêm cấu hình giống như cho Windsurf vào dưới mcpServers.
5. Lưu và khởi động lại Claude.

Cursor

1. Đảm bảo đã cài đặt Máy chủ MCP 1Panel.

2. Lấy token truy cập và URL máy chủ.

3. Chỉnh sửa file cấu hình Cursor.

4. Thêm:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<token truy cập 1Panel của bạn>",
           "PANEL_HOST": "ví dụ http://localhost:8080"
         }
       }
     }
   }
   

5. Lưu thay đổi và khởi động lại Cursor.

Ví dụ chế độ SSE

Nếu sử dụng chế độ SSE, khởi động máy chủ bằng:

mcp-1panel -host http://localhost:8080 -token <token truy cập 1Panel của bạn> -transport sse -addr http://localhost:8000

Thêm vào mcpServers:

{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Cline

1. Cài đặt Máy chủ MCP 1Panel.
2. Thiết lập PANEL_ACCESS_TOKEN và PANEL_HOST của bạn.
3. Chỉnh sửa file cấu hình Cline và thêm đoạn JSON giống trên.
4. Lưu và khởi động lại Cline.

Bảo mật API Key

Lưu trữ API key và thông tin nhạy cảm trong biến môi trường. Ví dụ cấu hình:

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "${PANEL_ACCESS_TOKEN}",
        "PANEL_HOST": "${PANEL_HOST}"
      }
    }
  }
}

Thay ${PANEL_ACCESS_TOKEN} và ${PANEL_HOST} bằng tên biến môi trường của bạn.

Cách sử dụng MCP này trong flow

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào workflow của bạn trên FlowHunt, hãy bắt đầu bằng cách thêm thành phần MCP vào flow và kết nối nó với tác nhân AI:

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình MCP hệ thống, hãy nhập thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, tác nhân AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng và khả năng. Hãy nhớ đổi “MCP-name” thành “mcp-1panel” và thay URL bằng URL máy chủ MCP của bạn.

Tổng quan

Nhận định của chúng tôi

Máy chủ MCP 1Panel có hướng dẫn cài đặt, tích hợp rõ ràng và được bảo trì tích cực với số lượng star và fork tốt. Tuy nhiên, tài liệu còn thiếu mô tả chi tiết về công cụ, prompt và resource nên khả năng sử dụng ngay cho workflow AI phức tạp còn hạn chế. Dựa trên các tiêu chí trên, chúng tôi đánh giá MCP này 5/10 về mức độ đầy đủ và thân thiện với lập trình viên.

MCP Score