Giới thiệu ServBay MCP Server
ServBay MCP Server là một máy chủ tích hợp trong ServBay, dựa trên Model Context Protocol (MCP). Nhờ MCP Server, các công cụ AI hỗ trợ MCP như Claude, Cursor, VS Code có thể trực tiếp “nhìn thấy” và “thao tác” với môi trường phát triển ServBay trên máy tính của bạn—truy vấn trạng thái dịch vụ, quản lý website và tên miền, thao tác với cơ sở dữ liệu, cấp phát chứng chỉ, tạo bản sao lưu, đọc nhật ký và các chỉ số hệ thống,… mà bạn không cần phải chuyển đổi qua lại giữa giao diện hội thoại AI và ServBay.
Tài liệu này giới thiệu ServBay MCP Server là gì, và những khả năng mà nó cung cấp. Cách kết nối và quy tắc dành cho AI, bạn có thể tham khảo tại:
- Kết nối AI Client (IDE Integration) — Kết nối MCP chỉ với một lần nhấp cho Claude Code / Cursor / VS Code,...
- Quy tắc dành cho AI (AI Rule) — Hướng dẫn AI sử dụng ServBay MCP đúng và an toàn
MCP là gì?
Model Context Protocol (MCP) là một giao thức mở, cho phép các ứng dụng AI kết nối với công cụ và nguồn dữ liệu ngoài theo cách thức chuẩn hóa. ServBay đóng gói năng lực quản lý môi trường của mình thành một MCP Server, bất kỳ ứng dụng AI nào tương thích MCP đều có thể sử dụng các chức năng của ServBay thông qua đó.
MCP Server được phân phối cùng với ServBay dưới dạng tiến trình cục bộ (giao tiếp qua stdio). Khi cần kết nối, AI client sẽ tự động khởi chạy, bạn không cần cài đặt hoặc triển khai riêng.
ServBay MCP có thể làm gì?
Các khả năng mà ServBay MCP Server cung cấp bao quát phạm vi quản lý cốt lõi của ServBay:
- Môi trường & Đăng ký — Đọc thông tin môi trường, trạng thái đăng ký/gói dịch vụ, chạy phân tích chẩn đoán.
- Thông tin & Chỉ số hệ thống — Đọc thông tin hệ thống như CPU/Memory/Disk/Network và các chỉ số thời gian thực (Xem chi tiết tại Thông tin & chỉ số hệ thống).
- Quản lý dịch vụ — Liệt kê dịch vụ, truy vấn trạng thái, khởi động/dừng/khởi động lại PHP, Node.js, MySQL, MariaDB, PostgreSQL, Redis, Memcached, Mailpit, MinIO, Ollama…
- Cấu hình & Nhật ký dịch vụ — Đọc/ghi cấu hình dịch vụ, đọc nhật ký dịch vụ.
- Website & Tên miền — Liệt kê/xem/tạo/cập nhật/xóa website cục bộ; bật/tắt website; quản lý bản ghi hosts & tên miền dnsmasq.
- Cổng (Port) — Kiểm tra tình trạng sử dụng cổng.
- Chứng chỉ TLS/HTTPS — Liệt kê, cấp phát, gia hạn, xóa chứng chỉ.
- Cơ sở dữ liệu — Liệt kê cơ sở dữ liệu, tạo cơ sở dữ liệu, đặt/làm mới mật khẩu cơ sở dữ liệu.
- Gói phần mềm — Liệt kê gói đã cài/khả dụng, cài đặt/gỡ/cấp quyền/tắt, chuyển đổi phiên bản.
- Mô hình Ollama — Liệt kê và xoá mô hình Ollama cục bộ.
- Sao lưu — Liệt kê, tạo, phục hồi, xóa bản sao lưu, xem các lịch trình sao lưu.
Nhờ vào các tính năng này, bạn có thể ra lệnh trực tiếp cho AI ví dụ như “Khởi động PHP 8.3 và tạo một website mới”, “Cấp chứng chỉ cho tên miền này”, hay “Xem nhật ký lỗi của MySQL”, và AI sẽ dùng MCP để thực hiện yêu cầu trên ServBay.
Lưu ý an toàn
- MCP Server chỉ chạy trên máy cục bộ, giao tiếp với AI client nội bộ qua stdio.
- Với những thao tác ghi hoặc có tính phá huỷ (như xóa website, đặt lại mật khẩu CSDL, phục hồi sao lưu), bạn nên yêu cầu AI diễn giải thay đổi sẽ thực hiện và xác nhận trước khi thao tác.
- Không nên dán khoá, token, API Key DNS, mật khẩu CSDL hay khoá riêng vào hội thoại—thiết kế của ServBay MCP không yêu cầu bạn cung cấp các thông tin nhạy cảm này.
- Kết hợp sử dụng Quy tắc dành cho AI để đảm bảo AI sử dụng ServBay MCP đúng chuẩn và an toàn nhất.
Điều kiện tiên quyết
- Đã cài đặt và chạy ServBay (trên macOS hoặc Windows).
- Có một AI client hỗ trợ MCP (Claude Code, Cursor, VS Code + Copilot, Claude Desktop, Codex, ...).
Bước tiếp theo
- Truy cập Kết nối AI Client, dễ dàng tích hợp ServBay MCP vào công cụ AI của bạn chỉ với một lần nhấp.
- Cài đặt Quy tắc dành cho AI để hướng dẫn AI sử dụng ServBay MCP đúng mục đích và chính xác nhất.
Tổng kết
ServBay MCP Server mở ra khả năng quản lý môi trường phát triển cho AI tool, giúp việc “quản lý môi trường phát triển cục bộ bằng ngôn ngữ tự nhiên” trở thành hiện thực. Nó được cung cấp sẵn cùng ServBay, dễ dàng tích hợp, không cần triển khai thêm, và là một thành phần thiết yếu định hướng AI-native cho tương lai phát triển của ServBay.
