Tích Hợp Máy Chủ KWDB MCP

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

KWDB MCP Server là một triển khai của Model Context Protocol (MCP) kết nối các trợ lý AI với cơ sở dữ liệu KWDB, cung cấp khả năng khai thác trí tuệ doanh nghiệp và thao tác dữ liệu. Đóng vai trò cầu nối, KWDB MCP Server cho phép các mô hình AI thực hiện truy vấn cơ sở dữ liệu, truy xuất metadata, sửa đổi dữ liệu và truy cập hướng dẫn cú pháp qua tập hợp công cụ và tài nguyên chuẩn hóa. Máy chủ hỗ trợ cả thao tác đọc và ghi (ví dụ: SELECT, INSERT, UPDATE, DDL), tự động quản lý giới hạn truy vấn để tối ưu hiệu suất, và chuẩn hóa phản hồi API theo định dạng JSON nhất quán. Máy chủ này nâng cao quy trình phát triển bằng cách đơn giản hóa truy cập cơ sở dữ liệu, đảm bảo an toàn với công cụ riêng cho đọc/ghi, và cung cấp metadata, cấu trúc bảng hữu ích cho client nhằm tạo ra tương tác LLM giàu ngữ cảnh.

Danh sách Prompts

• Syntax Guide: Truy cập hướng dẫn cú pháp đầy đủ cho KWDB thông qua các mẫu prompt định sẵn, giúp người dùng và LLM tuân thủ cú pháp SQL chính xác khi thao tác với cơ sở dữ liệu.

Danh sách Tài nguyên

• Thông tin sản phẩm (kwdb://product_info): Chứa thông tin về phiên bản sản phẩm KWDB và các tính năng hỗ trợ.
• Metadata cơ sở dữ liệu (kwdb://db_info/{database_name}): Cung cấp chi tiết về một cơ sở dữ liệu cụ thể, gồm loại engine, chú thích và các bảng chứa bên trong.
• Cấu trúc bảng (kwdb://table/{table_name}): Hiển thị cấu trúc của một bảng cụ thể, bao gồm các cột và ví dụ truy vấn.

Danh sách Công cụ

• read-query: Thực thi các thao tác SQL chỉ đọc như SELECT, SHOW và EXPLAIN trên cơ sở dữ liệu KWDB.
• write-query: Thực thi các thao tác SQL sửa đổi như INSERT, UPDATE, DELETE và các lệnh DDL (CREATE, DROP, ALTER).

Ứng dụng của MCP Server này

• Quản lý Cơ sở dữ liệu: Cho phép lập trình viên thực thi cả lệnh đọc và ghi trên KWDB, tối ưu hóa thao tác dữ liệu và thay đổi cấu trúc ngay từ giao diện AI.
• Trí tuệ Doanh nghiệp: Hỗ trợ truy vấn và phân tích dữ liệu kinh doanh qua truy cập dữ liệu có cấu trúc bởi LLM, phục vụ báo cáo và dashboard.
• Khám phá Mã nguồn để tìm dữ liệu: Giúp lập trình viên hoặc agent AI truy xuất cấu trúc bảng và metadata, dễ dàng tìm hiểu và thao tác cơ sở dữ liệu KWDB lớn hoặc chưa quen thuộc.
• Tích hợp API cho ứng dụng dữ liệu: Kết nối app hoặc quy trình AI với KWDB như backend, cung cấp endpoint chuẩn hóa để truy xuất và thao tác dữ liệu.
• Tự động hướng dẫn cú pháp: Cung cấp prompt và hướng dẫn cú pháp cho LLM/người dùng, giảm lỗi SQL và nâng cao hiệu quả phát triển.

Cách thiết lập

Windsurf

1. Đảm bảo các điều kiện cần thiết (ví dụ Node.js, môi trường hỗ trợ MCP).
2. Xác định file cấu hình Windsurf (ví dụ: windsurf.config.json).
3. Thêm KWDB MCP Server vào object mcpServers với lệnh và đối số phù hợp.
4. Lưu cấu hình và khởi động lại Windsurf.
5. Kiểm tra KWDB MCP Server đã xuất hiện trong danh sách MCP servers.

Ví dụ cấu hình JSON:

{
  "mcpServers": {
    "kwdb": {
      "command": "npx",
      "args": ["@KWDB/mcp-server@latest"]
    }
  }
}

Bảo mật API key:

{
  "mcpServers": {
    "kwdb": {
      "command": "npx",
      "args": ["@KWDB/mcp-server@latest"],
      "env": {
        "KWDB_API_KEY": "${KWDB_API_KEY}"
      },
      "inputs": {
        "database_url": "your_kwdb_connection_string"
      }
    }
  }
}

Claude

1. Xác nhận các phụ thuộc cần thiết đã được cài.
2. Mở file cấu hình máy chủ MCP của Claude.
3. Thêm cấu hình KWDB MCP Server dưới object mcpServers.
4. Lưu và khởi động lại Claude hoặc tải lại cấu hình.
5. Kiểm tra đăng ký KWDB MCP Server.

Ví dụ cấu hình JSON:

{
  "mcpServers": {
    "kwdb": {
      "command": "npx",
      "args": ["@KWDB/mcp-server@latest"]
    }
  }
}

Bảo mật API key:

{
  "mcpServers": {
    "kwdb": {
      "command": "npx",
      "args": ["@KWDB/mcp-server@latest"],
      "env": {
        "KWDB_API_KEY": "${KWDB_API_KEY}"
      },
      "inputs": {
        "database_url": "your_kwdb_connection_string"
      }
    }
  }
}

Cursor

1. Cài đặt Node.js và đảm bảo đã có hỗ trợ MCP.
2. Sửa file cấu hình Cursor (ví dụ: .cursorrc).
3. Thêm KWDB MCP Server với lệnh và đối số.
4. Lưu file và khởi động lại Cursor.
5. Xác nhận KWDB MCP Server hiển thị trong danh sách MCP servers.

Ví dụ cấu hình JSON:

{
  "mcpServers": {
    "kwdb": {
      "command": "npx",
      "args": ["@KWDB/mcp-server@latest"]
    }
  }
}

Bảo mật API key:

{
  "mcpServers": {
    "kwdb": {
      "command": "npx",
      "args": ["@KWDB/mcp-server@latest"],
      "env": {
        "KWDB_API_KEY": "${KWDB_API_KEY}"
      },
      "inputs": {
        "database_url": "your_kwdb_connection_string"
      }
    }
  }
}

Cline

1. Đáp ứng tất cả điều kiện để tích hợp MCP server.
2. Cập nhật cấu hình Cline để thêm KWDB MCP Server.
3. Thêm lệnh và đối số dưới object mcpServers.
4. Lưu và khởi động lại Cline.
5. Kiểm tra server hoạt động như mong đợi.

Ví dụ cấu hình JSON:

{
  "mcpServers": {
    "kwdb": {
      "command": "npx",
      "args": ["@KWDB/mcp-server@latest"]
    }
  }
}

Bảo mật API key:

{
  "mcpServers": {
    "kwdb": {
      "command": "npx",
      "args": ["@KWDB/mcp-server@latest"],
      "env": {
        "KWDB_API_KEY": "${KWDB_API_KEY}"
      },
      "inputs": {
        "database_url": "your_kwdb_connection_string"
      }
    }
  }
}

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

Sử dụng MCP trong FlowHunt

Để tích hợp MCP server vào workflow của FlowHunt, hãy thêm thành phần MCP vào flow và kết nối với agent AI của bạn:

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, điền chi tiết server MCP của bạn theo định dạng JSON sau:

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

Sau khi cấu hình, agent AI sẽ có thể sử dụng MCP này như một công cụ với toàn bộ chức năng của nó. Lưu ý đổi "kwdb" thành tên thực tế của máy chủ MCP và thay URL bằng địa chỉ server MCP của bạn.

Tổng quan

Đánh giá của chúng tôi

KWDB MCP Server cung cấp tài liệu rõ ràng cho các tính năng chính, công cụ và tài nguyên, hỗ trợ tốt cho tích hợp MCP cơ bản. Tuy nhiên, mẫu prompt còn hạn chế (chỉ hướng dẫn cú pháp được tài liệu hóa), chưa có thông tin về Roots hoặc Sampling. Tiện ích cho thao tác cơ sở dữ liệu tiêu chuẩn rất mạnh, nhưng hỗ trợ các tính năng MCP/LLM nâng cao ở mức trung bình.

MCP Score: 6/10

MCP Score