README.md•2.42 kB
# MySQL Custom MCP Server
MCP server tùy chỉnh để thao tác với MySQL database từ Cline AI. Server này cho phép thực hiện các truy vấn SQL và tương tác với MySQL databases thông qua giao thức Model Context Protocol (MCP).
## Tính năng
- Thực thi các câu truy vấn SQL
- Lấy danh sách các bảng trong database
- Hỗ trợ connection string tùy chỉnh
## Cài đặt
1. Clone repository
2. Cài đặt dependencies:
```bash
npm install
```
3. Build project:
```bash
npm run build
```
## Sử dụng
### Chạy server
```bash
npm start
```
Hoặc chạy trong chế độ development:
```bash
npm run dev
```
### Cấu hình
Bạn có thể cấu hình kết nối MySQL thông qua biến môi trường:
- `MYSQL_HOST`: Hostname của MySQL server (mặc định: "localhost")
- `MYSQL_PORT`: Port của MySQL server (mặc định: 3306)
- `MYSQL_DB`: Database mặc định (mặc định: "mysql")
- `MYSQL_USER`: Username (mặc định: "root")
- `MYSQL_PASSWORD`: Password (mặc định: "")
Hoặc cấu hình trong file `cline_mcp_settings.json`.
## Tools
### execute_query
Thực thi một câu truy vấn SQL.
**Tham số**:
- `query`: Câu lệnh SQL cần thực thi (bắt buộc)
- `params`: Mảng các tham số cho câu query (tùy chọn)
- `connectionString`: Connection string tùy chỉnh (tùy chọn)
**Ví dụ**:
```javascript
{
"query": "SELECT * FROM users WHERE id = ?",
"params": ["1"]
}
```
### list_tables
Lấy danh sách các bảng trong database.
**Tham số**:
- `database`: Tên database (tùy chọn, mặc định lấy từ connection)
- `connectionString`: Connection string tùy chỉnh (tùy chọn)
**Ví dụ**:
```javascript
{
"database": "my_database"
}
```
## Connection String
Server hỗ trợ connection string với định dạng:
```
Host=localhost;Port=3306;Database=my_database;User=root;Password=your_password
```
Các key hỗ trợ:
- Host, Server, DataSource: Địa chỉ máy chủ
- Port: Cổng kết nối
- Database, DB, Initial Catalog: Tên database
- User, Username, UID: Tên đăng nhập
- Password, PWD: Mật khẩu
## Lưu ý
MCP server này cần được chạy như một process riêng biệt và Cline AI sẽ giao tiếp với nó thông qua giao thức MCP. Thông tin cấu hình cần được đặt trong file `cline_mcp_settings.json` của Cline.