Máy chủ KurrentDB MCP

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

Máy chủ KurrentDB MCP là một công cụ được thiết kế để giúp trợ lý AI và nhà phát triển tương tác liền mạch với KurrentDB, một cơ sở dữ liệu dựa trên luồng. Bằng cách cung cấp bộ công cụ và các thao tác chuẩn hóa, máy chủ này cho phép khách hàng truy vấn, đọc và ghi dữ liệu luồng, cũng như xây dựng và quản lý chiếu dữ liệu trực tiếp từ môi trường phát triển AI. Việc tích hợp này nâng cao quy trình làm việc bằng cách cho phép thực hiện các tác vụ như truy xuất luồng sự kiện, ghi sự kiện mới và tạo chiếu dữ liệu một cách lập trình hoặc thông qua ngôn ngữ tự nhiên. Máy chủ KurrentDB MCP đơn giản hóa việc tạo mẫu, gỡ lỗi và khám phá dữ liệu hướng sự kiện, đặc biệt hữu ích cho phát triển và phân tích nhanh trong các ứng dụng sử dụng KurrentDB.

Danh sách Prompt

• read_stream: Mẫu truy xuất sự kiện từ một luồng chỉ định, với tùy chọn hướng và giới hạn.
• write_events_to_stream: Mẫu thêm sự kiện vào một luồng, chỉ định loại sự kiện, dữ liệu và siêu dữ liệu.
• list_streams: Mẫu liệt kê các luồng khả dụng, hỗ trợ phân trang và hướng.
• build_projection: Mẫu mô tả và tạo chiếu dữ liệu mới với sự trợ giúp của AI.
• create_projection: Mẫu tạo chiếu dữ liệu từ một đặc tả.
• update_projection: Mẫu cập nhật một chiếu dữ liệu hiện có.
• test_projection: Mẫu kiểm thử chiếu dữ liệu với dữ liệu mẫu.
• get_projections_status: Mẫu truy xuất trạng thái của tất cả chiếu dữ liệu.

Danh sách Tài nguyên

• Dữ liệu Luồng: Truy cập dữ liệu sự kiện trong KurrentDB, hỗ trợ đọc và phân tích.
• Danh sách Luồng: Danh sách và siêu dữ liệu của các luồng có trong cơ sở dữ liệu.
• Chiếu dữ liệu: Định nghĩa và các khung nhìn tính toán (projections) từ dữ liệu luồng.
• Trạng thái Chiếu dữ liệu: Thông tin trạng thái theo thời gian thực của các chiếu dữ liệu hiện có.

Danh sách Công cụ

• read_stream: Đọc sự kiện từ một luồng cụ thể, với tùy chọn thứ tự (ngược/thuận) và số lượng.
• write_events_to_stream: Thêm sự kiện mới vào luồng với dữ liệu, loại sự kiện và siêu dữ liệu tùy chỉnh.
• list_streams: Trả về danh sách tất cả luồng khả dụng trong KurrentDB.
• build_projection: Sử dụng AI để tạo chiếu dữ liệu dựa trên yêu cầu người dùng.
• create_projection: Tạo chiếu dữ liệu mới trong KurrentDB.
• update_projection: Cập nhật chiếu dữ liệu hiện có với đặc tả mới.
• test_projection: Kiểm thử chiếu dữ liệu bằng dữ liệu mẫu hoặc kịch bản.
• get_projections_status: Truy xuất trạng thái và thông tin sức khỏe cho tất cả chiếu dữ liệu.

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

• Khám phá sự kiện trong cơ sở dữ liệu: Nhà phát triển dễ dàng xem, lọc và phân tích dữ liệu sự kiện thời gian thực hoặc lịch sử ở bất kỳ luồng KurrentDB nào, đơn giản hóa kiểm tra và kiểm toán.
• Ghi nhận và lưu nhật ký sự kiện: Ghi nhận sự kiện mới (ví dụ: hành động người dùng, thay đổi hệ thống) vào cơ sở dữ liệu để tăng cường event sourcing và truy vết.
• Phát triển và gỡ lỗi chiếu dữ liệu: Nhanh chóng xây dựng, kiểm thử và hoàn thiện chiếu dữ liệu cho phân tích hoặc mô hình dữ liệu dẫn xuất, rút ngắn chu kỳ phản hồi cho các tính năng dữ liệu.
• Khám phá siêu dữ liệu luồng: Liệt kê tất cả luồng và xem cấu trúc hoặc siêu dữ liệu để phục vụ thiết kế schema hoặc điều hướng dữ liệu.
• Giám sát hoạt động: Sử dụng các công cụ để kiểm tra trạng thái và sức khỏe chiếu dữ liệu, đảm bảo các biến đổi dữ liệu quan trọng đang vận hành đúng.

Cách thiết lập

Windsurf

1. Điều kiện cần: Đảm bảo Python đã cài đặt và KurrentDB đang chạy với chiếu dữ liệu bật (--run-projections=all --start-standard-projections).
2. Mở cấu hình: Mở .codeium/windsurf/mcp_config.json.
3. Thêm máy chủ KurrentDB MCP:

   {
     "mcpServers": {
       "kurrentdb": {
         "command": "python",
         "args": ["path to mcp-server folder\\server.py"],
         "env": {
           "KURRENTDB_CONNECTION_STRING": "chèn chuỗi kết nối kurrentdb tại đây"
         }
       }
     }
   }
   

4. Lưu và Khởi động lại: Lưu cấu hình và khởi động lại Windsurf.
5. Kiểm tra thiết lập: Đảm bảo máy chủ MCP đã hoạt động và kết nối.

Claude

1. Điều kiện cần: Đã cài đặt Python, KurrentDB chạy với đủ cờ chiếu dữ liệu.
2. Mở cấu hình: Chỉnh sửa file cấu hình Claude Desktop của bạn.
3. Thêm máy chủ KurrentDB MCP:

   {
     "servers": {
       "KurrentDB": {
         "type": "stdio",
         "command": "uv",
         "args": [
           "--directory",
           "path to mcp-server folder",
           "run",
           "server.py"
         ],
         "env": {
           "KURRENTDB_CONNECTION_STRING": "chèn chuỗi kết nối kurrentdb tại đây"
         }
       }
     }
   }
   

4. Lưu và Khởi động lại: Lưu và khởi động lại Claude Desktop.
5. Kiểm tra: Đảm bảo KurrentDB MCP xuất hiện trên giao diện Claude.

Cursor

1. Điều kiện cần: Đã thiết lập Python và KurrentDB như trên.
2. Mở cấu hình: Chỉnh sửa .cursor/mcp.json.
3. Thêm máy chủ KurrentDB MCP:

   {
     "mcpServers": {
       "kurrentdb": {
         "command": "python",
         "args": ["path to mcp-server folder\\server.py"],
         "env": {
           "KURRENTDB_CONNECTION_STRING": "chèn chuỗi kết nối kurrentdb tại đây"
         }
       }
     }
   }
   

4. Lưu và Khởi động lại: Lưu và khởi động lại Cursor.
5. Kiểm tra: Đảm bảo máy chủ MCP đang chạy và truy cập được.

Cline

Không có hướng dẫn cụ thể nào được cung cấp trong kho lưu trữ cho thiết lập Cline.

Bảo mật khóa API

Sử dụng biến môi trường trong cấu hình:

"env": {
  "KURRENTDB_CONNECTION_STRING": "chèn chuỗi kết nối kurrentdb tại đây"
}

Điều này giúp giữ thông tin đăng nhập an toàn và không bị lộ trên hệ thống kiểm soát phiên bản.

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

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình FlowHunt của bạn, hãy bắt đầu bằng cách 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 hệ thống MCP, chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "kurrentdb": {
    "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 đầy đủ chức năng và khả năng. Hãy nhớ thay thế “kurrentdb” bằng tên thực tế của máy chủ MCP của bạn và thay URL bằng đường dẫn máy chủ MCP thật của bạn.

Tổng quan

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

KurrentDB MCP Server được tài liệu hóa rõ ràng và cung cấp bộ công cụ, tài nguyên toàn diện để tương tác với luồng và chiếu dữ liệu trong KurrentDB. Hướng dẫn cấu hình rõ ràng cho các nền tảng lớn, tuy nhiên một số tính năng MCP nâng cao như Roots và Sampling chưa được đề cập. Tổng thể, MCP này rất ổn định cho mục tiêu sử dụng với cơ sở dữ liệu.

Đánh giá: 8/10

Điểm MCP