Máy chủ “MariaDB” MCP làm gì?

MariaDB MCP Server là một công cụ được xây dựng nhằm cung cấp quyền truy cập chỉ đọc cho các trợ lý AI vào các cơ sở dữ liệu MariaDB. Đóng vai trò là một máy chủ Model Context Protocol (MCP), nó cho phép các workflow phát triển dựa trên AI kết nối trực tiếp với các nguồn dữ liệu MariaDB bên ngoài. Việc tích hợp này cho phép trợ lý AI thực hiện các tác vụ như lấy lược đồ cơ sở dữ liệu và thực hiện các truy vấn chỉ đọc, rất hữu ích cho phân tích dữ liệu, phát triển ứng dụng và thông minh doanh nghiệp. Bằng cách tạo cầu nối giữa các mô hình ngôn ngữ lớn và dữ liệu trực tiếp, MariaDB MCP Server giúp tương tác an toàn, hiệu quả và giàu ngữ cảnh, tăng năng suất phát triển mà không ảnh hưởng đến tính toàn vẹn của cơ sở dữ liệu.

Danh sách Prompt

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

Danh sách Resource

• Hiển thị danh sách lược đồ
  Máy chủ hiển thị danh sách các lược đồ trong cơ sở dữ liệu MariaDB đã kết nối, cho phép client xem cấu trúc dữ liệu hiện có.
  (Không có resource nào khác được đề cập rõ ràng.)

Danh sách Công cụ

• query_database
  Cho phép thực thi các thao tác chỉ đọc với một phiên bản MariaDB. Công cụ này giúp người dùng thực hiện truy vấn SELECT và lấy dữ liệu phục vụ phân tích hoặc tích hợp vào các workflow.

Ứng dụng thực tế của máy chủ MCP này

• Khám phá cơ sở dữ liệu
  Nhà phát triển và nhà khoa học dữ liệu có thể lấy thông tin lược đồ và truy vấn chỉ đọc để hiểu cấu trúc cơ sở dữ liệu MariaDB mà không lo chỉnh sửa nhầm.

• Thông minh doanh nghiệp
  Cho phép trợ lý AI tạo dashboard hoặc báo cáo bằng cách truy vấn dữ liệu trực tiếp từ MariaDB một cách an toàn, chỉ đọc.

• Gỡ lỗi ứng dụng
  Nhà phát triển có thể sử dụng máy chủ để kiểm tra và xác thực dữ liệu một cách an toàn trên cơ sở dữ liệu sản xuất, hỗ trợ cho việc khắc phục sự cố và xác minh.

• Phân tích dữ liệu tự động
  Công cụ AI có thể lấy và xử lý bản ghi cơ sở dữ liệu cho các mục đích phân tích thống kê, nhận diện xu hướng hoặc huấn luyện mô hình machine learning.

Cách thiết lập

Windsurf

Không có hướng dẫn cụ thể cho Windsurf trong tài liệu hiện có.

Claude

1. Xác định vị trí tệp cấu hình:
   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Thêm cấu hình máy chủ MCP:
   Thêm đoạn JSON sau, thay thế các giá trị mẫu bằng giá trị thực tế:

   {
       "mcpServers": {
           "mcp_server_mariadb": {
               "command": "/PATH/TO/uvx",
               "args": [
                   "mcp-server-mariadb",
                   "--host",
                   "${DB_HOST}",
                   "--port",
                   "${DB_PORT}",
                   "--user",
                   "${DB_USER}",
                   "--password",
                   "${DB_PASSWORD}",
                   "--database",
                   "${DB_NAME}"
               ]
           }
       }
   }
   

3. Thay thế các giá trị mẫu:
   • Thay /PATH/TO/uvx thành đường dẫn đầy đủ đến file thực thi uvx của bạn.
4. Lưu và khởi động lại Claude:
   • Lưu thay đổi và khởi động lại Claude Desktop để kích hoạt máy chủ.
5. Kiểm tra kết nối:
   • Đảm bảo máy chủ đang chạy và kết nối thành công tới MariaDB.

Ví dụ cho máy chủ phát triển/chưa phát hành:

{
    "mcpServers": {
        "mcp_server_mariadb": {
            "command": "/PATH/TO/uv",
            "args": [
                "--directory",
                "/YOUR/SOURCE/PATH/mcp-server-mariadb/src/mcp_server_mariadb",
                "run",
                "server.py"
            ],
            "env": {
                "MARIADB_HOST": "127.0.0.1",
                "MARIADB_USER": "USER",
                "MARIADB_PASSWORD": "PASSWORD",
                "MARIADB_DATABASE": "DATABASE",
                "MARIADB_PORT": "3306"
            }
        }
    }
}

Nhớ thay thế đầy đủ các đường dẫn và thông tin xác thực mẫu.

Cursor

Không có hướng dẫn cụ thể cho Cursor trong tài liệu hiện có.

Cline

Không có hướng dẫn cụ thể cho Cline trong tài liệu hiện có.

Bảo mật API Key

Khi cấu hình môi trường, hãy sử dụng biến môi trường cho thông tin xác thực nhạy cảm. Ví dụ:

"env": {
    "MARIADB_HOST": "127.0.0.1",
    "MARIADB_USER": "USER",
    "MARIADB_PASSWORD": "PASSWORD",
    "MARIADB_DATABASE": "DATABASE",
    "MARIADB_PORT": "3306"
}

Lưu các giá trị một cách an toàn và không bao giờ ghi cứng thông tin bí mật vào file cấu hình.

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

Sử dụng MCP trong FlowHunt

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

Nhấn 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, chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "mcp_server_mariadb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Khi đã cấu hình, agent AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Nhớ thay "mcp_server_mariadb" thành tên thực tế của máy chủ MCP bạn sử dụng và thay đường dẫn URL bằng địa chỉ máy chủ MCP của bạn.

Tổng quan

Dựa trên bảng trên, Máy chủ MariaDB MCP là một giải pháp đơn giản và tập trung, cung cấp chức năng thiết yếu cho truy cập cơ sở dữ liệu MariaDB. Nó không có các tính năng MCP nâng cao như prompt template hoặc sampling, nhưng làm tốt ở các điểm cơ bản như công cụ, resource và cấu hình bảo mật. Đối với một máy chủ cơ sở dữ liệu chỉ đọc, đây là một lựa chọn chắc chắn và cơ bản.

Điểm MCP