Couchbase MCP Server

Máy chủ “Couchbase” MCP dùng để làm gì?

Máy chủ Couchbase MCP là một triển khai của Model Context Protocol (MCP) cho phép các Mô hình Ngôn ngữ Lớn (LLM) và trợ lý AI tương tác trực tiếp với dữ liệu được lưu trữ trong các cụm Couchbase. Đóng vai trò như một tầng trung gian, máy chủ này giúp tích hợp liền mạch các thao tác cơ sở dữ liệu Couchbase vào quy trình phát triển ứng dụng có AI hỗ trợ. Máy chủ hỗ trợ các tác vụ như lấy cấu trúc collection, truy xuất tài liệu theo ID, chèn/cập nhật hoặc xóa tài liệu, và thực thi truy vấn SQL++. Khi kết nối LLM với dữ liệu Couchbase trực tiếp, lập trình viên có thể tự động hóa quản lý cơ sở dữ liệu, tăng hiệu suất và đơn giản hóa các thao tác dữ liệu phức tạp qua giao diện ngôn ngữ tự nhiên. Máy chủ có thể cấu hình chế độ chỉ đọc hoặc đọc-ghi, và tương thích với nhiều client MCP như Claude Desktop, Cursor, Windsurf.

Danh sách Prompt

Không có thông tin về mẫu prompt trong kho lưu trữ.

Danh sách Resource

Không có định nghĩa resource rõ ràng nào được ghi lại trong file repo hoặc README.

Danh sách Tools

• Lấy danh sách toàn bộ scope và collection: Truy xuất metadata về tổ chức của một bucket Couchbase cụ thể.
• Lấy cấu trúc một collection: Truy cập thông tin cấu trúc (schema) của một collection nhất định.
• Lấy tài liệu theo ID: Lấy một tài liệu từ scope và collection xác định bằng ID duy nhất.
• Chèn/cập nhật tài liệu theo ID: Thêm mới hoặc cập nhật tài liệu trong scope và collection xác định.
• Xóa tài liệu theo ID: Xóa một tài liệu khỏi scope và collection xác định.
• Chạy truy vấn SQL++: Thực thi truy vấn SQL++ chỉ đọc hoặc (tuỳ chọn) cho phép ghi trên scope xác định. Mặc định, các truy vấn thay đổi dữ liệu sẽ bị tắt để đảm bảo an toàn.

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

• Quản lý cơ sở dữ liệu: Tự động hóa các thao tác thường gặp như thêm, cập nhật, xóa tài liệu trực tiếp qua giao diện AI, giảm thao tác thủ công.
• Khám phá dữ liệu: Cho phép lập trình viên và tác nhân AI nhanh chóng khám phá cấu trúc dữ liệu, collection và nội dung tài liệu để phân tích hoặc debug.
• Truy vấn tương tác: Hỗ trợ truy vấn ngôn ngữ tự nhiên chuyển hóa thành SQL++ và thực thi trên Couchbase, giúp người không chuyên cũng dễ dàng truy vấn dữ liệu.
• Tạo báo cáo tự động: Hỗ trợ tạo báo cáo động bằng cách truy vấn và tổng hợp dữ liệu qua workflow AI.
• Tích hợp liền mạch vào quy trình phát triển: Tăng năng suất bằng cách tích hợp truy cập dữ liệu Couchbase vào các công cụ như Claude, Cursor hoặc Windsurf, hỗ trợ lập trình và viết tài liệu theo ngữ cảnh.

Cách cài đặt

Windsurf

1. Điều kiện: Đảm bảo đã cài đặt Python 3.10+ và uv; có quyền truy cập vào cụm Couchbase.
2. Clone repo:

   git clone https://github.com/Couchbase-Ecosystem/mcp-server-couchbase.git
   

3. Chỉnh sửa cấu hình client MCP của Windsurf để thêm máy chủ Couchbase MCP:

   {
     "mcpServers": {
       "couchbase": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/cloned/repo/mcp-server-couchbase/",
           "run",
           "src/mcp_server.py"
         ],
         "env": {
           "CB_CONNECTION_STRING": "couchbases://connection-string",
           "CB_USERNAME": "username",
           "CB_PASSWORD": "password",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. Khởi động lại Windsurf để áp dụng thay đổi.
5. Kiểm tra kết nối bằng cách chạy truy vấn thử.

Claude

1. Điều kiện: Python 3.10+, uv, quyền truy cập cụm Couchbase, đã cài Claude Desktop.
2. Clone repo Couchbase MCP Server.
3. Tìm file cấu hình:
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Thêm cấu hình máy chủ như trên vào phần mcpServers.
5. Khởi động lại Claude Desktop.
6. Kiểm tra bằng cách truy vấn dữ liệu Couchbase qua giao diện Claude.

Cursor

1. Đảm bảo có Python 3.10+, uv, và quyền truy cập Couchbase cluster.
2. Clone repo và cài đặt các phụ thuộc nếu cần.
3. Thêm máy chủ Couchbase MCP vào cấu hình Cursor:

   {
     "mcpServers": {
       "couchbase": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/cloned/repo/mcp-server-couchbase/",
           "run",
           "src/mcp_server.py"
         ],
         "env": {
           "CB_CONNECTION_STRING": "couchbases://connection-string",
           "CB_USERNAME": "username",
           "CB_PASSWORD": "password",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. Khởi động lại Cursor.
5. Kiểm tra bằng cách thực hiện thao tác cơ sở dữ liệu.

Cline

1. Đáp ứng yêu cầu: Python 3.10+, uv, cụm Couchbase.
2. Clone repo về máy.
3. Thêm sau vào cấu hình MCP của Cline:

   {
     "mcpServers": {
       "couchbase": {
         "command": "uv",
         "args": [
           "--directory",
           "path/to/cloned/repo/mcp-server-couchbase/",
           "run",
           "src/mcp_server.py"
         ],
         "env": {
           "CB_CONNECTION_STRING": "couchbases://connection-string",
           "CB_USERNAME": "username",
           "CB_PASSWORD": "password",
           "CB_BUCKET_NAME": "bucket_name"
         }
       }
     }
   }
   

4. Lưu lại và khởi động lại Cline.
5. Xác nhận cài đặt bằng cách thực hiện thao tác cơ sở dữ liệu.

Bảo mật API Key:
Tất cả giá trị nhạy cảm (ví dụ: CB_PASSWORD) được lưu dưới dạng biến môi trường trong phần env của cấu hình.
Ví dụ:

"env": {
  "CB_CONNECTION_STRING": "couchbases://connection-string",
  "CB_USERNAME": "username",
  "CB_PASSWORD": "password",
  "CB_BUCKET_NAME": "bucket_name"
}

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

Sử dụng MCP trong FlowHunt

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

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

{ “couchbase”: { “transport”: “streamable_http”, “url”: “https://yourmcpserver.example/pathtothemcp/url" } }

Sau khi cấu hình, tác nhân AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng. Lưu ý thay “couchbase” bằng tên thực tế của máy chủ MCP của bạn và thay URL bằng URL máy chủ MCP của bạn.

Tổng quan

Dựa trên bảng trên, Couchbase MCP Server được ghi lại tốt về cài đặt và công cụ, nhưng thiếu template prompt, định nghĩa resource và tài liệu về sampling/roots. Tiện ích cho tác vụ cơ sở dữ liệu rõ ràng, song có thể nâng cấp với các tính năng MCP gốc hơn. Tôi đánh giá máy chủ MCP này 6/10 cho mục đích LLM và lập trình viên nói chung.

Điểm MCP