Máy chủ Azure Data Explorer MCP

Máy chủ “Azure Data Explorer” MCP làm gì?

Azure Data Explorer (ADX) MCP Server là một máy chủ Model Context Protocol (MCP) cho phép các trợ lý AI kết nối liền mạch với các cụm và cơ sở dữ liệu Azure Data Explorer/Eventhouse. Thông qua giao diện MCP tiêu chuẩn, nó giúp các công cụ và agent AI thực thi truy vấn KQL (Kusto Query Language), khám phá tài nguyên cơ sở dữ liệu, lấy sơ đồ bảng, lấy mẫu dữ liệu và truy cập thống kê bảng. Máy chủ này hỗ trợ các công cụ tương tác và xác thực bằng thông tin Azure, giúp quản lý và phân tích dữ liệu quy mô lớn một cách an toàn trực tiếp từ quy trình AI. Sự tích hợp này giúp tăng hiệu suất phát triển bằng cách tự động hóa khám phá, truy vấn và quản lý dữ liệu trong môi trường Azure Data Explorer.

Danh sách Prompt

Không có template prompt rõ ràng nào được đề cập trong kho lưu trữ.

Danh sách tài nguyên

• Liệt kê bảng
  • Cho phép trợ lý AI liệt kê tất cả các bảng trong cơ sở dữ liệu Azure Data Explorer đã cấu hình.
• Sơ đồ bảng
  • Cung cấp thông tin sơ đồ của một bảng đã chọn, gồm tên và kiểu của các cột.
• Lấy mẫu dữ liệu bảng
  • Cho phép lấy mẫu các dòng dữ liệu từ bất kỳ bảng nào để cung cấp ngữ cảnh hoặc xem trước cho các tác vụ tiếp theo.
• Thống kê bảng
  • Truy xuất thống kê chi tiết hoặc metadata của bảng, như số dòng và kích thước.

Danh sách công cụ

• Thực thi truy vấn KQL
  • Thực thi các truy vấn Kusto Query Language (KQL) trên cơ sở dữ liệu Azure Data Explorer đã kết nối.
• Liệt kê bảng
  • Lấy danh sách tất cả các bảng có trong cơ sở dữ liệu chỉ định.
• Xem sơ đồ bảng
  • Truy cập và hiển thị cấu trúc (sơ đồ) của một bảng đã chọn.
• Lấy mẫu dữ liệu bảng
  • Lấy một mẫu nhỏ dữ liệu từ bảng để kiểm tra hoặc cung cấp ngữ cảnh.
• Lấy thống kê bảng
  • Lấy thống kê hoặc thông tin tổng quan về một bảng, như số dòng và thông tin lưu trữ.

Trường hợp sử dụng của MCP Server này

• Quản lý cơ sở dữ liệu
  • Tự động hóa việc liệt kê bảng, lấy sơ đồ và lấy mẫu dữ liệu, giúp đơn giản hóa khám phá và quản lý cơ sở dữ liệu cho nhà phát triển và nhà khoa học dữ liệu.
• Phân tích dữ liệu tương tác
  • Nhanh chóng thực thi truy vấn KQL và lấy kết quả cho phân tích khám phá, giúp trợ lý AI và người dùng dễ dàng rút ra insight từ tập dữ liệu lớn.
• Khám phá dữ liệu dựa trên AI
  • Cho phép LLM hoặc agent AI duyệt, tóm tắt và tạo ngữ cảnh từ dữ liệu Azure Data Explorer, hỗ trợ các trường hợp như tạo báo cáo hoặc phát hiện bất thường.
• Tích hợp vào pipeline DevOps
  • Tận dụng MCP server trong quy trình CI/CD để kiểm tra dữ liệu, thực hiện health check và đảm bảo dữ liệu sẵn sàng trước khi triển khai.
• Vận hành dữ liệu chú trọng bảo mật
  • Sử dụng xác thực Azure và hỗ trợ identity workload để đảm bảo truy cập an toàn, tuân thủ đến các cơ sở dữ liệu nhạy cảm trong doanh nghiệp.

Cách thiết lập

Windsurf

1. Đảm bảo đã cài đặt Node.js và các điều kiện tiên quyết khác.
2. Mở tệp cấu hình Windsurf của bạn.
3. Thêm máy chủ Azure Data Explorer MCP bằng đoạn JSON sau:

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

4. Lưu cấu hình và khởi động lại Windsurf.
5. Kiểm tra máy chủ MCP đã chạy và truy cập được.

Bảo mật API key (Windsurf)

{
  "mcpServers": {
    "adx-mcp": {
      "command": "npx",
      "args": ["@adx/mcp-server@latest"],
      "env": {
        "ADX_CLUSTER_URL": "https://yourcluster.region.kusto.windows.net",
        "ADX_DATABASE": "your_database"
      },
      "inputs": {}
    }
  }
}

Claude

1. Cài đặt các phụ thuộc cần thiết để tích hợp MCP trong Claude.
2. Xác định vị trí tệp cấu hình của Claude.
3. Thêm cấu hình MCP server như sau:

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

4. Lưu thay đổi và khởi động lại Claude.
5. Xác nhận kết nối máy chủ hoạt động bình thường.

Bảo mật API key (Claude)

{
  "mcpServers": {
    "adx-mcp": {
      "command": "npx",
      "args": ["@adx/mcp-server@latest"],
      "env": {
        "ADX_CLUSTER_URL": "https://yourcluster.region.kusto.windows.net",
        "ADX_DATABASE": "your_database"
      },
      "inputs": {}
    }
  }
}

Cursor

1. Cài đặt Node.js và đảm bảo Cursor có thể truy cập các MCP server bên ngoài.
2. Mở tệp cấu hình MCP server của Cursor.
3. Thêm JSON cấu hình MCP server như sau:

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

4. Lưu và khởi động lại Cursor.
5. Kiểm tra tích hợp MCP bằng cách chạy một truy vấn KQL mẫu.

Bảo mật API key (Cursor)

{
  "mcpServers": {
    "adx-mcp": {
      "command": "npx",
      "args": ["@adx/mcp-server@latest"],
      "env": {
        "ADX_CLUSTER_URL": "https://yourcluster.region.kusto.windows.net",
        "ADX_DATABASE": "your_database"
      },
      "inputs": {}
    }
  }
}

Cline

1. Xác nhận đã cài đặt Node.js và Cline.
2. Chỉnh sửa tệp cấu hình MCP của Cline.
3. Thêm máy chủ như sau:

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

4. Lưu tệp và khởi động lại Cline.
5. Đảm bảo kết nối bằng cách thực hiện một truy vấn sơ đồ cơ sở dữ liệu.

Bảo mật API key (Cline)

{
  "mcpServers": {
    "adx-mcp": {
      "command": "npx",
      "args": ["@adx/mcp-server@latest"],
      "env": {
        "ADX_CLUSTER_URL": "https://yourcluster.region.kusto.windows.net",
        "ADX_DATABASE": "your_database"
      },
      "inputs": {}
    }
  }
}

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

Sử dụng MCP trong FlowHunt

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

Nhấp vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình hệ thống MCP, chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "adx-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, agent AI có thể sử dụng MCP này như một công cụ với đầy đủ chức năng và khả năng của nó. Hãy nhớ đổi “adx-mcp” thành tên thực tế của MCP server và thay URL bằng địa chỉ MCP server của bạn.

Tổng quan

Dựa trên thông tin cung cấp và mức độ đầy đủ, MCP server này được đánh giá khoảng 7/10. Nó đáp ứng hầu hết các yêu cầu MCP chính cho Azure Data Explorer, nhưng thiếu template prompt rõ ràng và chi tiết về hỗ trợ roots.

Điểm MCP