Cài đặt và cấu hình MySQL MCP
Bước cài đặt
1. Cài đặt phiên bản ổn định
npm install -g @benborla29/mcp-server-mysql@2.0.2
2. Kiểm tra cài đặt
npm list -g @benborla29/mcp-server-mysql
Kết quả nên hiển thị: @benborla29/mcp-server-mysql@2.0.2
Tệp cấu hình
Cấu hình cơ bản (chế độ chỉ đọc)
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": ["-y", "@benborla29/mcp-server-mysql@2.0.2"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASS": "root",
"MYSQL_DB": "admin-demo"
}
}
}
}
Cấu hình nâng cao (hỗ trợ DDL)
Nếu cần thực hiện các thao tác DDL như tạo, xóa bảng, sử dụng cấu hình sau:
{
"mcpServers": {
"mysql": {
"command": "npx",
"args": ["-y", "@benborla29/mcp-server-mysql@2.0.2"],
"env": {
"MYSQL_HOST": "localhost",
"MYSQL_PORT": "3306",
"MYSQL_USER": "root",
"MYSQL_PASS": "root",
"MYSQL_DB": "admin-demo",
"SCHEMA_DDL_PERMISSIONS": "true"
}
}
}
}
Giải thích cấu hình
- Cấu hình cơ bản: Chỉ cho phép các thao tác truy vấn (SELECT, SHOW, v.v.), an toàn hơn.
- Cấu hình nâng cao: Cho phép các thao tác DDL (CREATE, DROP, ALTER, v.v.), đầy đủ tính năng nhưng cần cẩn thận khi sử dụng.
- SCHEMA_DDL_PERMISSIONS: Đặt giá trị "true" để mở quyền DDL.
Yêu cầu môi trường
Cơ sở dữ liệu MySQL
- Trạng thái dịch vụ: Đang chạy
- Cổng: 3306
- Người dùng: root
- Mật khẩu: root
- Cơ sở dữ liệu: admin-demo
Môi trường hệ thống
- Hệ điều hành: Windows
- Node.js: Đã cài đặt
- npm: Đã cài đặt
- IDE: Trae.ai
Hướng dẫn sử dụng
Sử dụng cơ bản (chế độ chỉ đọc)
- Sao chép cấu hình: Sao chép tệp cấu hình cơ bản vào cài đặt MCP của Trae.ai
- Khởi động lại ứng dụng: Khởi động lại ứng dụng Trae.ai
- Kiểm tra kết nối: Kiểm tra kết nối MySQL MCP trong Trae.ai
- Bắt đầu sử dụng: Truy vấn cơ sở dữ liệu bằng ngôn ngữ tự nhiên (chỉ hỗ trợ truy vấn)
Sử dụng nâng cao (hỗ trợ DDL)
- Sao chép cấu hình nâng cao: Sao chép tệp cấu hình nâng cao vào cài đặt MCP của Trae.ai
- Khởi động lại ứng dụng: Khởi động lại ứng dụng Trae.ai
- Kiểm tra kết nối: Kiểm tra kết nối MySQL MCP trong Trae.ai
- Chức năng đầy đủ: Thực hiện các thao tác truy vấn, tạo bảng, sửa đổi cấu trúc bảng, v.v.
Lời khuyên về quyền chọn
- Môi trường học tập: Nên sử dụng cấu hình nâng cao, thuận tiện cho việc học và thử nghiệm
- Môi trường sản xuất: Nên sử dụng cấu hình cơ bản, đảm bảo an toàn dữ liệu
- Môi trường phát triển: Tùy theo nhu cầu, đề nghị bắt đầu với cấu hình cơ bản để kiểm tra kết nối
Lệnh thường dùng
Kiểm tra kết nối cơ sở dữ liệu
D:\phpstudy_pro\Extensions\MySQL5.7.26\bin\mysql.exe -u root -proot -e "SELECT 1;"
Xem danh sách cơ sở dữ liệu
D:\phpstudy_pro\Extensions\MySQL5.7.26\bin\mysql.exe -u root -proot -e "SHOW DATABASES;"
Kiểm tra trạng thái dịch vụ MySQL
Qua giao diện quản lý PHPStudy
Lưu ý quan trọng
Phiên bản
- Phiên bản khuyến nghị: 2.0.2 (ổn định)
- Phiên bản tránh: 2.0.5 (vấn đề tương thích với Windows)
Lưu ý cấu hình
- Sau mỗi lần thay đổi cấu hình, phải khởi động lại Trae.ai
- Đảm bảo dịch vụ MySQL đang chạy
- Đảm bảo cơ sở dữ liệu
admin-demotồn tại - Người dùng
rootcần có quyền truy cập
Giải quyết sự cố
Nếu kết nối thất bại
- Kiểm tra dịch vụ MySQL: Đảm bảo MySQL đang chạy
- Xác nhận cơ sở dữ liệu: Xác nhận cơ sở dữ liệu
admin-demotồn tại - Kiểm tra kết nối: Sử dụng lệnh dòng lệnh để kiểm tra kết nối cơ sở dữ liệu
- Khởi động lại ứng dụng: Khởi động lại ứng dụng Trae.ai
- Kiểm tra phiên bản: Xác nhận đang sử dụng phiên bản 2.0.2
Nếu không thể thực hiện thao tác DDL
- Kiểm tra cấu hình: Xác nhận đang sử dụng cấu hình nâng cao
- Xác nhận quyền: Xác nhận cấu hình chứa
"SCHEMA_DDL_PERMISSIONS": "true" - Khởi động lại ứng dụng: Sau khi thay đổi cấu hình, phải khởi động lại Trae.ai
- Kiểm tra quyền: Thử thực hiện một câu lệnh CREATE TABLE đơn giản
Lỗi thường gặp
- MCP error -32008: Thường là do phiên bản, sử dụng phiên bản 2.0.2 để giải quyết
- Kết nối quá hạn: Kiểm tra trạng thái dịch vụ MySQL
- Lỗi quyền: Kiểm tra cài đặt quyền người dùng
- DDL operations are not allowed: Cần sử dụng cấu hình nâng cao để mở quyền DDL