Couchbase
chính thứcTương tác với dữ liệu được lưu trữ trong các cụm Couchbase bằng ngôn ngữ tự nhiên.
Bạn có thể làm gì với Couchbase MCP?
- Khám phá dữ liệu cụm — Liệt kê các bucket, scope và collection, sau đó suy luận lược đồ của một collection như
orders. - Chạy truy vấn SQL++ — Thực thi các truy vấn SQL++ chỉ đọc trên một bucket và scope, đồng thời giải thích kế hoạch truy vấn.
- Kiểm tra tài liệu — Lấy tài liệu theo ID hoặc đọc các đường dẫn subdocument cụ thể mà không cần tải toàn bộ tài liệu.
- Kiểm tra tình trạng cụm — Báo cáo tình trạng cụm, các dịch vụ đang chạy và chẩn đoán kết nối.
- Phân tích hiệu năng truy vấn — Tìm các truy vấn chạy lâu nhất, thường xuyên nhất hoặc không sử dụng chỉ mục bao phủ.
- Truy vấn tìm kiếm và vector — Chạy tìm kiếm toàn văn và truy vấn độ tương đồng vector trên các chỉ mục đã cấu hình.
Tài liệu
Couchbase MCP Server
Couchbase MCP Server là một Server MCP tự lưu trữ, cho phép các tác nhân AI kết nối và tương tác với dữ liệu trong Couchbase Servers (dù được lưu trữ trên Capella hay tự quản lý) hoặc Operational Insights Enterprise. Server cung cấp các công cụ thuộc nhiều danh mục, bao gồm Tình trạng cụm, Lược đồ dữ liệu, Truy vấn và nhiều danh mục khác — cùng các biện pháp kiểm soát an toàn thông qua chế độ chỉ đọc và khả năng vô hiệu hóa công cụ chi tiết. Server hỗ trợ cả phương thức truyền tải STDIO và Streamable HTTP, cùng các khả năng OAuth.
Couchbase MCP Server được phân phối dưới dạng gói Python Package Index (PyPI) và qua Docker. Có thể nhận hỗ trợ doanh nghiệp cho Couchbase MCP Server bằng cách cấp phép Couchbase AI Data Plane; giấy phép này cũng cho phép sử dụng và nhận hỗ trợ doanh nghiệp cho Couchbase Agent Memory và Couchbase Agent Catalog.
Tài liệu đầy đủ: docs.couchbase.com/mcp-server
Mục lục
- Lý do chọn Couchbase MCP Server
- Chọn một Server
- Operational Server
- Operational Insights Server
- Cấu hình chung
- Thiết lập client
- Docker
- Khắc phục sự cố
- Câu hỏi thường gặp
- Đóng góp
- Dữ liệu sử dụng, rủi ro LLM và chính sách hỗ trợ
Lý do chọn Couchbase MCP Server
- An toàn theo mặc định — các công cụ ghi không được tải và các truy vấn sửa đổi dữ liệu bị chặn trừ khi bạn đặt
CB_MCP_READ_ONLY_MODE=false; bạn cũng có thể vô hiệu hóa từng công cụ hoặc yêu cầu người dùng xác nhận trước khi sử dụng. - Couchbase Server và Operational Insights — operational server kết nối với Couchbase Capella hoặc cụm Couchbase Server tự quản lý bằng cùng một cấu hình; Operational Insights server kết nối với các cụm Operational Insights tự quản lý.
- Nhận biết RBAC — các biện pháp kiểm soát công cụ hướng dẫn LLM; quyền kiểm soát truy cập dựa trên vai trò của người dùng Couchbase vẫn là ranh giới bảo mật có thẩm quyền.
- Phương thức truyền tải sẵn sàng cho môi trường production — STDIO dành cho client máy tính để bàn cục bộ, hoặc Streamable HTTP với OAuth 2.1 tùy chọn (mọi IdP công bố JWKS: Auth0, Okta, Keycloak, Entra, Cognito, …), kiểm tra tình trạng và ghi nhật ký kiểm tra cho các triển khai dùng chung. Operational server cũng có thể chạy nhiều worker để sử dụng thêm lõi CPU.
- Mọi MCP client — đã được kiểm thử với Claude Desktop, Cursor, Windsurf, VS Code và JetBrains AI Assistant/Junie.
Sau khi kết nối, bạn có thể hỏi những câu như:
- "Tôi có những bucket, scope và collection nào, và lược đồ của collection
orderslà gì?" - "Tìm 10 tài liệu mới nhất trong
usersmàstatus = 'active'." - "5 truy vấn chậm nhất trong giờ qua là gì, và có truy vấn nào thiếu covering index không?"
- "Cụm này có khỏe mạnh không, và những dịch vụ nào đang chạy?"
- "Chèn một tài liệu mới vào
productsvới các trường sau: …" (cầnCB_MCP_READ_ONLY_MODE=false)
Chọn một Server
Gói này cung cấp hai MCP server. Mỗi server được khởi chạy bằng một subcommand riêng, kết nối với một loại cụm khác nhau và có bộ công cụ riêng. Hãy chọn server phù hợp với cụm của bạn, làm theo phần hướng dẫn tương ứng để thiết lập và sử dụng công cụ, sau đó tham khảo Cấu hình chung để biết các thiết lập dùng chung. Để sử dụng cả hai, hãy đăng ký từng server riêng biệt trong MCP client.
| Operational server | Operational Insights server | |
|---|---|---|
| Sử dụng với | Cụm Couchbase (Capella hoặc tự quản lý) | Cụm Operational Insights tự quản lý (không có trên Capella) |
| Subcommand | operational (mặc định) | operational-insights |
| Chuỗi kết nối | couchbase:// / couchbases:// | URL HTTP(S), ví dụ: http://localhost:8095 |
| Biến thông tin xác thực | CB_CONNECTION_STRING, CB_USERNAME, … | CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING, CB_OPERATIONAL_INSIGHTS_USERNAME, … |
| Công cụ | 52 — tình trạng cụm, lược đồ, KV, SQL++, chỉ mục, tìm kiếm toàn văn và vector, hiệu năng truy vấn | 13 — lược đồ, SQL++ (đồng bộ và bất đồng bộ), chỉ mục, xuất dữ liệu |
| Cổng HTTP mặc định | 8000 | 8001 |
| Tệp nhật ký mặc định | mcp_server.log | mcp_server_operational_insights.log |
Hiện tại, subcommand không bắt buộc đối với operational server — chỉ cần chạy
couchbase-mcp-serverlà khởi chạy server — nhưng ghi rõ subcommand giúp cấu hình của bạn không bị mơ hồ. Các tùy chọn phải đặt sau subcommand:couchbase-mcp-server operational --transport=http. Kiểm tra phiên bản đã cài bằnguvx couchbase-mcp-server --version.
Operational Server
Server operational kết nối với cụm Couchbase trên Capella hoặc Couchbase Server tự quản lý, sử dụng couchbase Python SDK.
Bắt đầu nhanh với Operational
Bạn cần một cụm Couchbase đang chạy — gói miễn phí Capella là cách nhanh nhất để có một cụm (bạn có thể nhập tập dữ liệu mẫu) — và một MCP client. Thêm một trong các cấu hình sau vào client của bạn (xem Thiết lập client để biết vị trí tệp cấu hình của từng client). Nếu client đã có các server khác, hãy thêm couchbase vào đối tượng mcpServers hiện có.
Từ PyPI bằng uvx (cần uv và Python 3.11 trở lên):
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational"],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
Dùng Docker (chỉ cần Docker):
{
"mcpServers": {
"couchbase": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "CB_CONNECTION_STRING=couchbases://connection-string",
"-e", "CB_USERNAME=username",
"-e", "CB_PASSWORD=password",
"couchbase/mcp-server:latest", "operational"
]
}
}
}
Từ mã nguồn
git clone https://github.com/couchbase/mcp-server-couchbase.git
{
"mcpServers": {
"couchbase": {
"command": "uv",
"args": [
"--directory", "path/to/cloned/repo/mcp-server-couchbase/",
"run", "src/mcp_server.py", "operational"
],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
path/to/cloned/repo/mcp-server-couchbase/ là đường dẫn đến bản sao kho mã của bạn — giữ nguyên dấu gạch chéo ở cuối. Sau khi tải các bản cập nhật, chạy uv sync để cập nhật các phần phụ thuộc.
Kết nối và xác thực với Operational
Sử dụng một trong hai phương thức: tên người dùng và mật khẩu hoặc chứng chỉ client (mTLS). Nếu đặt cả hai, chứng chỉ sẽ được sử dụng.
| Biến môi trường | Đối số CLI | Mô tả |
|---|---|---|
CB_CONNECTION_STRING | --connection-string | Chuỗi kết nối đến cụm. Bắt buộc |
CB_USERNAME / CB_PASSWORD | --username / --password | Xác thực cơ bản |
CB_CLIENT_CERT_PATH / CB_CLIENT_KEY_PATH | --client-cert-path / --client-key-path | Xác thực mTLS |
CB_CA_CERT_PATH | --ca-cert-path | Chứng chỉ gốc cho chứng chỉ máy chủ tự ký/không đáng tin cậy (không cần thiết với Capella) |
Ví dụ mTLS
{
"mcpServers": {
"couchbase": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational"],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_CLIENT_CERT_PATH": "/path/to/client-certificate.pem",
"CB_CLIENT_KEY_PATH": "/path/to/client.key"
}
}
}
}
Công cụ của Operational
Các công cụ ghi (được đánh dấu ✏️) không được tải khi chế độ chỉ đọc đang bật; đây là chế độ mặc định. Các công cụ được đánh dấu 🖥️ chỉ dành cho môi trường tự quản lý — chúng sử dụng các endpoint REST quản trị mà Capella không cung cấp, hoặc (discover_tool_input_values) chỉ cung cấp dữ liệu tham chiếu cho một công cụ có sử dụng endpoint đó — vì vậy chúng cần Couchbase Server 7.6+ tự quản lý và không được đăng ký trên các kết nối Capella.
Thiết lập và tình trạng cụm
| Công cụ | Mô tả |
|---|---|
get_server_configuration_status | Trạng thái và cấu hình server mà không cần kết nối với cụm: chế độ chỉ đọc, công cụ bị vô hiệu hóa/cần xác nhận, OAuth, ghi nhật ký và bộ đếm kiểm tra |
test_cluster_connection | Kiểm tra thông tin xác thực của cụm bằng cách kết nối với cụm |
get_cluster_health_and_services | Tình trạng cụm và các dịch vụ đang chạy, có thể lọc bằng service_types |
get_client_connectivity_report | Thông tin chẩn đoán kết nối được SDK lưu trong bộ nhớ đệm, không chủ động thăm dò mạng |
get_cluster_metrics 🖥️ | Thống kê cụm trong một khoảng thời gian lịch sử (endpoint stats-range) |
get_cluster_tasks 🖥️ | Các tác vụ đang chạy — cân bằng lại, nén, XDCR, tạo chỉ mục. Cần ro_admin |
get_cluster_health_snapshot 🖥️ | Tình trạng từng node: cấu trúc liên kết dịch vụ, trạng thái thành viên, node điều phối và tổng hợp tình trạng. Cần ro_admin |
get_bucket_config 🖥️ | Cấu hình và trạng thái trực tiếp của một bucket (hoặc tất cả bucket) — hạn mức, chính sách loại bỏ, bản sao, độ bền, lưu trữ, nén. Cần ro_admin |
get_cluster_system_events 🖥️ | Nhật ký sự kiện hệ thống (thay đổi cấu hình, chuyển đổi dự phòng, cân bằng lại, khởi động lại), giới hạn theo khoảng thời gian bằng since_time. Cần Full Admin hoặc Cluster Admin |
discover_tool_input_values 🖥️ | Tra cứu các giá trị đầu vào chính xác mà công cụ khác cần (ví dụ: mọi tên chỉ số cho get_cluster_metrics). Hoạt động ngoại tuyến |
Khám phá mô hình dữ liệu và lược đồ
| Công cụ | Mô tả |
|---|---|
get_buckets_in_cluster | Liệt kê tất cả bucket trong cụm |
get_scopes_in_bucket | Liệt kê tất cả scope trong một bucket |
get_collections_in_scope | Liệt kê tất cả collection trong một scope (cần dịch vụ Query) |
get_scopes_and_collections_in_bucket | Liệt kê tất cả scope và collection trong một bucket |
get_schema_for_collection | Suy luận cấu trúc của một collection |
create_scope ✏️ | Tạo scope trong một bucket (Server 7.6+ và Capella) |
create_collection ✏️ | Tạo collection trong một scope hiện có (Server 7.6+ và Capella) |
delete_scope ✏️ | Xóa scope và tất cả collection trong scope đó — không thể khôi phục |
delete_collection ✏️ | Xóa collection và tất cả tài liệu trong collection đó — không thể khôi phục |
Thao tác tài liệu (KV)
| Công cụ | Mô tả |
|---|---|
get_document_by_id | Lấy tài liệu theo ID |
lookup_subdocument | Đọc các đường dẫn cụ thể, kiểm tra sự tồn tại hoặc đếm mà không cần tải toàn bộ tài liệu |
upsert_document_by_id ✏️ | Upsert tài liệu theo ID |
insert_document_by_id ✏️ | Chèn tài liệu mới (thất bại nếu tài liệu đã tồn tại) |
replace_document_by_id ✏️ | Thay thế tài liệu hiện có (thất bại nếu tài liệu không tồn tại) |
delete_document_by_id ✏️ | Xóa tài liệu theo ID |
mutate_subdocument ✏️ | Sửa đổi các đường dẫn trong tài liệu hiện có (upsert, chèn, thay thế, xóa, thao tác mảng, bộ đếm) |
Truy vấn và lập chỉ mục
| Công cụ | Mô tả |
|---|---|
run_sql_plus_plus_query | Chạy truy vấn SQL++ trong phạm vi một bucket và scope — sử dụng trực tiếp tên collection (SELECT * FROM users). Các câu lệnh sửa đổi dữ liệu bị chặn trong chế độ chỉ đọc |
explain_sql_plus_plus_query | Tạo và đánh giá kế hoạch EXPLAIN: siêu dữ liệu, kế hoạch được trích xuất và các phát hiện |
get_index_advisor_recommendations | Đề xuất từ Index Advisor cho truy vấn SQL++ |
list_indexes | Liệt kê chỉ mục cùng định nghĩa, có thể lọc theo bucket/scope/collection/tên; đánh dấu chỉ mục vector (is_vector, vector_type) |
get_index_stats 🖥️ | Kích thước, mức phân mảnh, lưu lượng quét và độ trễ của từng chỉ mục trên từng node — giúp phát hiện áp lực và chỉ mục không được sử dụng |
create_query_index ✏️ | Tạo chỉ mục GSI scalar, vector Hyperscale hoặc vector Composite (index_type). Mặc định được hoãn — tiếp theo hãy chạy build_index |
create_index ✏️ | Không còn được khuyến nghị — hãy dùng create_query_index. Đã bị xóa trong phiên bản 2.0 |
build_index ✏️ | Tạo tất cả chỉ mục đang chờ trên một collection |
drop_index ✏️ | Xóa chỉ mục GSI (scalar hoặc vector) |
Tìm kiếm toàn văn (FTS)
Cần Couchbase Server 7.6+ và dịch vụ Search. Hỗ trợ cả chỉ mục cấp scope và chỉ mục cấp cụm (kiểu cũ): truyền đồng thời bucket_name và scope_name cho chỉ mục cấp scope, hoặc bỏ qua cả hai.
| Công cụ | Mô tả |
|---|---|
list_search_indexes | Liệt kê các chỉ mục Search — cấp cụm, theo bucket hoặc theo scope |
get_search_index_definition | Định nghĩa đầy đủ của một chỉ mục Search (ánh xạ, bộ phân tích, tham số kế hoạch) |
run_search | Chạy bất kỳ truy vấn FTS không vector nào từ phần thân JSON thô; explain=true trả về kế hoạch thực thi |
upsert_search_index ✏️ | Tạo hoặc cập nhật chỉ mục Search, bao gồm ánh xạ trường vector. Các bản cập nhật kích hoạt quá trình dựng lại toàn bộ — truyền uuid hiện tại để tránh ghi đè các thay đổi đồng thời |
drop_search_index ✏️ | Xóa chỉ mục Search — không thể khôi phục |
Tìm kiếm vector
Cả hai công cụ đều nhúng văn bản truy vấn thuần bằng mô hình được cấu hình trong Embedding Providers. Khả dụng trên Couchbase Server tự quản lý và Capella.
| Công cụ | Mô tả |
|---|---|
run_vector_query | Tìm kiếm độ tương đồng trên chỉ mục vector GSI (Server 8.0+) thông qua APPROX_VECTOR_DISTANCE(). Chỉ mục được tự động chọn; hỗ trợ bộ lọc trước SQL++ where và tinh chỉnh Hyperscale (num_probes, rerank, top_n_scan). Trả về toàn bộ tài liệu |
run_vector_search | Tìm kiếm vector bằng dịch vụ Search (Server 7.6+) trên một chỉ mục được đặt tên. scalar_query biến tìm kiếm thành tìm kiếm kết hợp; prefilter thu hẹp các ứng viên trước. Trả về các trường được lưu trong chỉ mục cho mỗi kết quả |
Phân tích hiệu năng truy vấn
| Công cụ | Mô tả |
|---|---|
get_longest_running_queries | Các truy vấn chạy lâu nhất theo thời gian dịch vụ trung bình |
get_most_frequent_queries | Các truy vấn được thực thi thường xuyên nhất |
get_queries_with_largest_response_sizes | Các truy vấn có kích thước phản hồi lớn nhất |
get_queries_with_large_result_count | Các truy vấn có số lượng kết quả lớn nhất |
get_queries_using_primary_index | Các truy vấn sử dụng chỉ mục chính |
get_queries_not_using_covering_index | Các truy vấn không sử dụng chỉ mục bao phủ |
get_queries_not_selective | Các truy vấn có lượt quét — chỉ mục phụ, chỉ mục chính hoặc tuần tự — trả về nhiều tài liệu hơn đáng kể so với kết quả cuối cùng |
Tình trạng dịch vụ Query 🖥️
Các công cụ này gọi API REST quản trị riêng của dịch vụ Query trên mỗi nút truy vấn.
| Công cụ | Mô tả |
|---|---|
get_cluster_query_vitals | Tình trạng bộ máy truy vấn: tốc độ yêu cầu, yêu cầu đang hoạt động/đang xếp hàng, bộ nhớ, GC, thời gian hoạt động. Cần ro_admin |
get_active_queries | Các truy vấn đang thực thi trên tất cả nút truy vấn. Cần ro_admin |
delete_active_query ✏️ | Hủy truy vấn đang chạy bằng ID yêu cầu. Cần Full Admin hoặc Cluster Admin |
Các công cụ tự động bị vô hiệu hóa trên Capella
Các công cụ 🖥️ truy cập Couchbase thông qua các điểm cuối REST quản trị mà Capella không cung cấp (ngoại lệ duy nhất là discover_tool_input_values, bị ẩn vì công cụ này chỉ phục vụ một công cụ cần đến chúng). Khi mọi máy chủ trong CB_CONNECTION_STRING đều kết thúc bằng .cloud.couchbase.com, máy chủ sẽ không đăng ký các công cụ này và liệt kê chúng cùng với các công cụ bị vô hiệu hóa của bạn trong get_server_configuration_status và nhật ký khởi động. Các công cụ dựa trên SDK như get_cluster_health_and_services và get_client_connectivity_report vẫn khả dụng.
| Công cụ | Điểm cuối cần thiết |
|---|---|
get_cluster_metrics | REST quản lý (/pools/default/stats/range) |
get_cluster_tasks | REST quản lý (/pools/default/tasks) |
get_bucket_config | REST quản lý (/pools/default/buckets[/<name>]) |
get_cluster_health_snapshot | REST quản lý, cùng các điểm cuối theo từng nút |
get_cluster_system_events | REST quản lý (/events) |
get_index_stats | REST của Index Service (/api/v1/stats của mỗi indexer) |
get_cluster_query_vitals | REST của dịch vụ Query (/admin/vitals) |
get_active_queries | REST của dịch vụ Query (/admin/active_requests) |
delete_active_query | REST của dịch vụ Query (DELETE /admin/active_requests/{id}) |
discover_tool_input_values | Không có (hoạt động ngoại tuyến), nhưng chỉ phục vụ get_cluster_metrics, tính năng mà Capella không có |
Nhà cung cấp embedding
run_vector_query và run_vector_search nhúng văn bản truy vấn bằng nhà cung cấp được đặt trong CB_MCP_EMBEDDING_MODEL_PROVIDER. Đây là tùy chọn: nếu không thiết lập, máy chủ vẫn khởi động bình thường và cả hai công cụ vẫn được đăng ký, nhưng khi gọi chúng sẽ trả về lỗi giải thích cần thiết lập gì.
CB_MCP_EMBEDDING_MODEL_PROVIDER | Bắt buộc | Tùy chọn | Ghi chú |
|---|---|---|---|
capella | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL, CB_MCP_EMBEDDING_MODEL_ENDPOINT | — | Capella Model Service. CB_MCP_EMBEDDING_MODEL_ENDPOINT là URL riêng của bản triển khai của bạn (ví dụ: https://<id>.ai.couchbase.com) từ Capella's AI Data Plane > Models |
openai | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_ENDPOINT | Đặt điểm cuối để sử dụng máy chủ cục bộ tương thích với OpenAI (Ollama, vLLM, LM Studio) |
cohere | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_ENDPOINT | |
voyage | CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_ENDPOINT | |
bedrock | CB_MCP_EMBEDDING_MODEL | CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY, CB_MCP_EMBEDDING_MODEL_AWS_REGION | Các mô hình embedding Amazon Titan (ví dụ: amazon.titan-embed-text-v2:0) — nhà cung cấp gửi yêu cầu theo cấu trúc inputText của Titan, vì vậy hiện chưa hỗ trợ các mô hình embedding Bedrock khác như Cohere Embed. Bỏ qua thông tin xác thực để sử dụng chuỗi AWS mặc định. Cần thêm: pip install couchbase-mcp-server[bedrock-embeddings] |
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password",
"CB_MCP_EMBEDDING_MODEL_PROVIDER": "openai",
"CB_MCP_EMBEDDING_MODEL": "text-embedding-3-small",
"CB_MCP_EMBEDDING_MODEL_API_KEY": "sk-..."
}
Tất cả tùy chọn
Mọi biến môi trường và cờ CLI dành cho máy chủ operational server
Máy chủ Operational Insights chấp nhận các tùy chọn tương tự, ngoại trừ việc máy chủ này có cài đặt kết nối riêng và không có tùy chọn CB_MCP_EMBEDDING_MODEL_*.
| Biến môi trường | Đối số CLI | Mô tả | Mặc định |
|---|---|---|---|
CB_CONNECTION_STRING | --connection-string | Chuỗi kết nối đến cụm Couchbase | Bắt buộc |
CB_USERNAME | --username | Tên người dùng có quyền truy cập vào các bucket cần thiết để xác thực cơ bản | Bắt buộc (hoặc cần Chứng chỉ và Khóa máy khách cho mTLS) |
CB_PASSWORD | --password | Mật khẩu dùng cho xác thực cơ bản | Bắt buộc (hoặc cần Chứng chỉ và Khóa máy khách cho mTLS) |
CB_CLIENT_CERT_PATH | --client-cert-path | Đường dẫn đến tệp chứng chỉ máy khách dùng cho xác thực mTLS | Bắt buộc nếu dùng mTLS (hoặc cần Tên người dùng và Mật khẩu) |
CB_CLIENT_KEY_PATH | --client-key-path | Đường dẫn đến tệp khóa máy khách dùng cho xác thực mTLS | Bắt buộc nếu dùng mTLS (hoặc cần Tên người dùng và Mật khẩu) |
CB_CA_CERT_PATH | --ca-cert-path | Đường dẫn đến chứng chỉ gốc của máy chủ dùng cho TLS nếu máy chủ được cấu hình bằng chứng chỉ tự ký/không đáng tin cậy. Không cần thiết nếu bạn kết nối với Capella | |
CB_MCP_READ_ONLY_MODE | --read-only-mode | Ngăn mọi sửa đổi dữ liệu (KV, Query, quản lý scope/collection, quản lý chỉ mục và quản lý chỉ mục FTS). Khi bật, các công cụ ghi sẽ không được tải. | true |
CB_MCP_TRANSPORT | --transport | Chế độ truyền tải: stdio, http | stdio |
CB_MCP_HOST | --host | Máy chủ lưu trữ cho chế độ truyền tải HTTP | 127.0.0.1 |
CB_MCP_PORT | --port | Cổng cho chế độ truyền tải HTTP | 8000 |
CB_MCP_WORKERS | --workers | Số lượng tiến trình worker của máy chủ cho chế độ truyền tải http. Giá trị lớn hơn 1 chạy ở chế độ HTTP không trạng thái (xem Nhiều worker) | 1 |
CB_MCP_STATELESS_HTTP | --stateless-http | Xử lý từng yêu cầu HTTP mà không duy trì trạng thái theo phiên. Chỉ có hiệu lực với http; không thể kết hợp với các công cụ yêu cầu xác nhận (xem Nhiều worker) | true khi số worker > 1, nếu không thì false |
CB_MCP_DISABLED_TOOLS | --disabled-tools | Các công cụ cần tắt (xem Tắt công cụ) | Không có |
CB_MCP_CONFIRMATION_REQUIRED_TOOLS | --confirmation-required-tools | Các công cụ yêu cầu người dùng xác nhận rõ ràng trước khi thực thi thông qua MCP elicitation (xem Yêu cầu xác nhận) | Không có |
CB_MCP_LOG_LEVEL | --log-level | Cấp độ ghi nhật ký cho máy chủ MCP: off, debug, info, warning, error (xem Ghi nhật ký) | info |
CB_MCP_LOG_SINKS | --log-sinks | Các đích ghi nhật ký, phân tách bằng dấu phẩy: stderr, file hoặc cả hai (xem Ghi nhật ký) | stderr |
CB_MCP_LOG_FILE | --log-file | Đường dẫn cơ sở cho các tệp nhật ký theo từng cấp độ (chỉ dùng khi bật sink file) | mcp_server.log |
CB_MCP_LOG_ROTATION_MAX_SIZE_MB | --log-rotation-max-size-mb | Kích thước tối đa toàn cục tính bằng MB cho mỗi tệp nhật ký trước khi xoay vòng; được áp dụng cho mọi cấp độ trừ khi có ghi đè. 0 — hoặc giá trị không hợp lệ, chẳng hạn số âm, nan hoặc inf — đều không hợp lệ và sẽ dùng giá trị mặc định kèm cảnh báo khi khởi động | 1 (1 MB) |
CB_MCP_LOG_MAX_BYTES | --log-max-bytes | Không dùng nữa — hãy dùng CB_MCP_LOG_ROTATION_MAX_SIZE_MB (MB). Kích thước xoay vòng toàn cục tính bằng byte, vẫn được hỗ trợ để tương thích ngược; bị bỏ qua khi đồng thời đặt CB_MCP_LOG_ROTATION_MAX_SIZE_MB | Chưa đặt |
CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB | --log-error-rotation-max-size-mb | Kích thước xoay vòng tính bằng MB cho tệp nhật ký ERROR; ghi đè CB_MCP_LOG_ROTATION_MAX_SIZE_MB đối với ERROR | Kế thừa CB_MCP_LOG_ROTATION_MAX_SIZE_MB |
CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB | --log-warning-rotation-max-size-mb | Kích thước xoay vòng tính bằng MB cho tệp nhật ký WARNING; ghi đè CB_MCP_LOG_ROTATION_MAX_SIZE_MB đối với WARNING | Kế thừa CB_MCP_LOG_ROTATION_MAX_SIZE_MB |
CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB | --log-info-rotation-max-size-mb | Kích thước xoay vòng tính bằng MB cho tệp nhật ký INFO; ghi đè CB_MCP_LOG_ROTATION_MAX_SIZE_MB đối với INFO | Kế thừa CB_MCP_LOG_ROTATION_MAX_SIZE_MB |
CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB | --log-debug-rotation-max-size-mb | Kích thước xoay vòng tính bằng MB cho tệp nhật ký DEBUG; ghi đè CB_MCP_LOG_ROTATION_MAX_SIZE_MB đối với DEBUG | Kế thừa CB_MCP_LOG_ROTATION_MAX_SIZE_MB |
CB_MCP_LOG_RETENTION_BACKUP_COUNT | --log-retention-backup-count | Số lượng tệp sao lưu đã xoay vòng được giữ lại cho mỗi tệp nhật ký theo cấp độ (không tính tệp hiện hành), áp dụng cho mọi cấp độ trừ khi có ghi đè. 0 chỉ giữ lại tệp hiện hành (xem Ghi nhật ký) | 1 |
CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT | --log-error-retention-backup-count | Số lượng tệp sao lưu đã xoay vòng được giữ lại cho tệp nhật ký ERROR; ghi đè số lượng toàn cục đối với ERROR | Kế thừa CB_MCP_LOG_RETENTION_BACKUP_COUNT |
CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT | --log-warning-retention-backup-count | Số lượng tệp sao lưu đã xoay vòng được giữ lại cho tệp nhật ký WARNING; ghi đè số lượng toàn cục đối với WARNING | Kế thừa CB_MCP_LOG_RETENTION_BACKUP_COUNT |
CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT | --log-info-retention-backup-count | Số lượng tệp sao lưu đã xoay vòng được giữ lại cho tệp nhật ký INFO; ghi đè số lượng toàn cục đối với INFO | Kế thừa CB_MCP_LOG_RETENTION_BACKUP_COUNT |
CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT | --log-debug-retention-backup-count | Số lượng tệp sao lưu đã xoay vòng được giữ lại cho tệp nhật ký DEBUG; ghi đè số lượng toàn cục đối với DEBUG | Kế thừa CB_MCP_LOG_RETENTION_BACKUP_COUNT |
CB_MCP_OAUTH_JWT_JWKS_URI | --oauth-jwks-uri | Điểm cuối JWKS của nhà cung cấp danh tính dùng để xác minh JWT bearer. Bật OAuth khi được đặt cùng với issuer và audience (xem Ủy quyền OAuth 2.1) | Không có |
CB_MCP_OAUTH_JWT_ISSUER | --oauth-issuer | Claim JWT iss dự kiến. Bắt buộc để bật OAuth | Không có |
CB_MCP_OAUTH_JWT_AUDIENCE | --oauth-audience | Claim JWT aud dự kiến. Bắt buộc để bật OAuth | Không có |
CB_MCP_OAUTH_JWT_ALGORITHM | --oauth-algorithm | Thuật toán ký JWT: một trong các giá trị RS256/384/512, ES256/384/512, PS256/384/512 | RS256 |
CB_MCP_OAUTH_MCP_BASE_URL | --oauth-mcp-base-url | URL cơ sở công khai của máy chủ này. Khi được đặt, máy chủ công bố Protected Resource Metadata theo RFC 9728 để các máy khách hỗ trợ PRM có thể tìm thấy IdP | Không có |
CB_MCP_OAUTH_SCOPE_READ_LABEL | --oauth-scope-read-label | Ghi đè nhãn phạm vi OAuth được xem là quyền truy cập 'read' (được quảng bá trong PRM và đối chiếu với claim scope/scp của token). Dùng khi IdP của bạn không thể phát ra dạng chuẩn | couchbase-mcp:read |
CB_MCP_OAUTH_SCOPE_WRITE_LABEL | --oauth-scope-write-label | Ghi đè nhãn phạm vi OAuth được xem là quyền truy cập 'write'; có cùng ngữ nghĩa với nhãn read | couchbase-mcp:write |
CB_MCP_AUDIT_LOG_ENABLED | --audit-log-enabled | Bật ghi nhật ký kiểm toán — một sink riêng biệt với nhật ký vận hành CB_MCP_LOG_*, có lược đồ ổn định và chính sách lưu giữ riêng (xem Kiểm toán) | false |
CB_MCP_AUDIT_LOG_SINKS | --audit-log-sinks | Các đích kiểm toán, phân tách bằng dấu phẩy: console, file hoặc cả hai. console ghi vào stderr — không bao giờ ghi vào stdout, nơi truyền giao thức JSON-RPC khi dùng stdio | console |
CB_MCP_AUDIT_LOG_FILE_PATH | --audit-log-file-path | Đường dẫn đến tệp nhật ký kiểm toán. Bắt buộc khi file nằm trong các sink; tên máy chủ và mã tiến trình được chèn trước phần mở rộng (audit.log → audit.<host>.<pid>.log) | Không có |
CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB | --audit-log-rotation-max-size-mb | Kích thước tối đa tính bằng MB mà tệp kiểm toán hiện hành có thể đạt tới trước khi xoay vòng. 0 tắt tính năng xoay vòng theo kích thước | 10 (10 MB) |
CB_MCP_AUDIT_LOG_ROTATION_INTERVAL | --audit-log-rotation-interval | Thời gian tồn tại tối đa của tệp kiểm toán hiện hành trước khi xoay vòng, theo định dạng <value><unit>, trong đó đơn vị là d (24 giờ) hoặc w (7 ngày) — ví dụ: 1d, 30d, 8w. 0 tắt tính năng xoay vòng theo khoảng thời gian | 1d |
CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS | --audit-log-retention-max-backups | Số lượng bản sao lưu đã xoay vòng được giữ lại cho mỗi tệp kiểm toán, không tính tệp hiện hành. Các bản sao lưu được nén bằng gzip. 0 không giữ lại bản sao lưu nào. Giới hạn này áp dụng cho một tệp, không phải thư mục — xem Kiểm toán | 10 |
CB_MCP_AUDIT_LOG_TOOL_ARGS | --audit-log-tool-args | Ghi lại giá trị đối số của công cụ trong nhật ký kiểm toán. Mặc định tắt — bản phát hành này không có chức năng che dữ liệu, vì vậy khi bật, các đối số sẽ được ghi nguyên văn, bao gồm toàn bộ nội dung tài liệu | false |
CB_MCP_AUDIT_LOG_DISABLED_EVENTS | --audit-log-disabled-events | Các sự kiện kiểm toán cần loại bỏ: mã sự kiện dạng số, phân tách bằng dấu phẩy (ví dụ: 61490,61492), hoặc một tệp có mỗi dòng chứa một mã. Chỉ có thể loại bỏ các sự kiện hỗ trợ lọc | Không có |
CB_MCP_EMBEDDING_MODEL_PROVIDER | --embedding-model-provider | Nhà cung cấp embedding cho run_vector_query / run_vector_search: một trong các giá trị capella, openai, cohere, voyage, bedrock. Nếu chưa đặt, bước embedding của cả hai công cụ sẽ bị tắt cho đến khi được cấu hình — xem Cấu hình nhà cung cấp embedding | Không có |
CB_MCP_EMBEDDING_MODEL | --embedding-model | Tên/mã định danh mô hình cho nhà cung cấp embedding đã cấu hình | Không có |
CB_MCP_EMBEDDING_MODEL_API_KEY | --embedding-model-api-key | Khóa API cho nhà cung cấp đã cấu hình. Không được bedrock sử dụng (thay vào đó dùng chuỗi thông tin xác thực AWS / CB_MCP_EMBEDDING_MODEL_AWS_*) | Không có |
CB_MCP_EMBEDDING_MODEL_ENDPOINT | --embedding-model-endpoint | Ghi đè URL cơ sở (máy chủ cục bộ tương thích OpenAI hoặc URL riêng của một bản triển khai Capella Model Service — bắt buộc khi dùng CB_MCP_EMBEDDING_MODEL_PROVIDER=capella) | Không có |
CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID | --embedding-model-aws-access-key-id | ID khóa truy cập AWS, chỉ dành cho nhà cung cấp bedrock. Bỏ qua để dùng chuỗi thông tin xác thực AWS mặc định | Không có |
CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY | --embedding-model-aws-secret-access-key | Khóa bí mật truy cập AWS, chỉ dành cho nhà cung cấp bedrock | Không có |
CB_MCP_EMBEDDING_MODEL_AWS_REGION | --embedding-model-aws-region | Khu vực AWS, chỉ dành cho nhà cung cấp bedrock. Nếu chưa đặt, sẽ dùng cơ chế phân giải khu vực riêng của AWS SDK | Không có |
Máy chủ Operational Insights
Máy chủ operational-insights kết nối với các cụm Operational Insights tự quản lý. Operational Insights là cơ sở dữ liệu phân tích thời gian thực (RT-OLAP) dành cho ứng dụng thời gian thực và phân tích vận hành. Máy chủ này không khả dụng cho Capella. Máy chủ sử dụng SDK couchbase-operational-insights. Máy chủ chạy dưới dạng tiến trình riêng, tách biệt với máy chủ vận hành.
[!IMPORTANT]
CB_OPERATIONAL_INSIGHTS_CONNECTION_STRINGlà URL HTTP(S), không phải chuỗi kết nốicouchbase://— ví dụ:http://localhost:8095, hoặchttps://<host>:18095qua TLS. Đây là lỗi cấu hình phổ biến nhất.
Bắt đầu nhanh với Operational Insights
Từ PyPI bằng uvx:
{
"mcpServers": {
"couchbase-operational-insights": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational-insights"],
"env": {
"CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING": "http://localhost:8095",
"CB_OPERATIONAL_INSIGHTS_USERNAME": "Administrator",
"CB_OPERATIONAL_INSIGHTS_PASSWORD": "password"
}
}
}
}
Với Docker:
{
"mcpServers": {
"couchbase-operational-insights": {
"command": "docker",
"args": [
"run", "--rm", "-i",
"-e", "CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING=http://host.docker.internal:8095",
"-e", "CB_OPERATIONAL_INSIGHTS_USERNAME=Administrator",
"-e", "CB_OPERATIONAL_INSIGHTS_PASSWORD=password",
"couchbase/mcp-server:latest", "operational-insights"
]
}
}
}
Để chạy từ mã nguồn, hãy dùng cấu hình mã nguồn vận hành, với operational-insights làm đối số cuối cùng và các biến ở trên.
Kết nối và xác thực Operational Insights
| Biến môi trường | Đối số CLI | Mô tả |
|---|---|---|
CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING | --connection-string | URL endpoint (HTTP/HTTPS). Bắt buộc |
CB_OPERATIONAL_INSIGHTS_USERNAME | --username | Tên người dùng |
CB_OPERATIONAL_INSIGHTS_PASSWORD | --password | Mật khẩu |
CB_OPERATIONAL_INSIGHTS_CA_CERT_PATH | --ca-cert-path | Chứng chỉ gốc (PEM) cho chứng chỉ máy chủ tự ký/không đáng tin cậy |
CB_OPERATIONAL_INSIGHTS_CLIENT_CERT_PATH | --client-cert-path | Chứng chỉ máy khách cho mTLS — PEM (kèm khóa) hoặc gói PKCS#12 (.p12/.pfx, không có khóa). Yêu cầu URL https://; ghi đè tên người dùng/mật khẩu |
CB_OPERATIONAL_INSIGHTS_CLIENT_KEY_PATH | --client-key-path | Khóa riêng (PEM) cho chứng chỉ máy khách. Để trống nếu dùng PKCS#12 |
CB_OPERATIONAL_INSIGHTS_CLIENT_CERT_PASSWORD | --client-cert-password | Mật khẩu cho khóa được mã hóa hoặc gói PKCS#12 |
CB_MCP_OPERATIONAL_INSIGHTS_QUERY_RESULT_MAX_SIZE | --operational-insights-query-result-max-size | Kích thước kết quả truy vấn tối đa tính bằng byte. Để trống nghĩa là không giới hạn. Khi được đặt, quá trình đọc dừng ở mức ngân sách và phản hồi báo truncated: true; hàng khiến vượt quá giới hạn sẽ không được trả về. Giá trị trên 4 MiB (4194304) được giới hạn ở 4 MiB, kèm cảnh báo trên stderr khi khởi động |
CB_MCP_OPERATIONAL_INSIGHTS_ASYNC_QUERY_RESULT_TIMEOUT | --operational-insights-async-query-result-timeout | Thời gian chờ tính bằng giây cho mỗi yêu cầu truy vấn bất đồng bộ: bắt đầu truy vấn, kiểm tra trạng thái, lấy kết quả, loại bỏ và hủy. Với thao tác lấy kết quả, thời gian này áp dụng cho toàn bộ quá trình tải xuống, vì vậy kết quả mất nhiều thời gian hơn mức này để đọc sẽ gây lỗi. Tăng giá trị này cho kết quả lớn hoặc kết nối chậm. Số nguyên dương, mặc định là 30, tối đa 600. Giá trị lớn hơn được giới hạn ở 600 kèm cảnh báo; mọi giá trị không hợp lệ khác đều được ghi nhật ký dưới dạng cảnh báo và sử dụng 30 |
Mọi cấu hình chung đều áp dụng, với những điểm khác biệt sau so với máy chủ vận hành:
- Cổng mặc định là
8001và tệp nhật ký mặc định làmcp_server_operational_insights.log, để cả hai máy chủ có thể chạy song song. - Chỉ hỗ trợ một worker (
CB_MCP_WORKERS=1), vì các handle truy vấn bất đồng bộ nằm trong bộ nhớ tiến trình. - Máy chủ này không có các tùy chọn
CB_MCP_EMBEDDING_MODEL_*.
Công cụ Operational Insights
Tên của tất cả công cụ, ngoại trừ get_server_configuration_status, đều có tiền tố operational_insights_, để có thể đăng ký cả hai máy chủ trong cùng một client mà không bị trùng lặp. Công cụ ghi (được đánh dấu ✏️) không được tải khi chế độ chỉ đọc đang bật; đây là chế độ mặc định.
Trạng thái máy chủ
| Công cụ | Mô tả |
|---|---|
get_server_configuration_status | Cùng công cụ như trên máy chủ vận hành |
Khám phá mô hình dữ liệu và lược đồ
| Công cụ | Mô tả |
|---|---|
operational_insights_get_databases_in_cluster | Liệt kê cơ sở dữ liệu |
operational_insights_get_scopes_in_database | Liệt kê các scope trong cơ sở dữ liệu |
operational_insights_get_collections_in_scope | Liệt kê các collection (tập dữ liệu) trong một scope |
operational_insights_get_schema_for_collection | Suy luận lược đồ JSON của collection bằng cách lấy mẫu |
Truy vấn và chỉ mục
| Công cụ | Mô tả |
|---|---|
operational_insights_list_indexes | Liệt kê các chỉ mục phụ từ System.Metadata.Index |
operational_insights_explain_query | Chạy EXPLAIN cho câu lệnh SQL++ mà không thực thi |
operational_insights_run_query_sync | Chạy SQL++ và trả về các hàng, tối đa bằng giới hạn kích thước kết quả; thay vào đó có thể xuất. Chế độ chỉ đọc được thực thi ở phía máy chủ |
operational_insights_run_query_async | Bắt đầu truy vấn chạy lâu và trả về query_handle mà không chờ các hàng; cũng được ưu tiên cho các lần xuất lớn. Chế độ chỉ đọc được thực thi ở phía máy chủ |
operational_insights_get_async_query_results | Thăm dò truy vấn bất đồng bộ; trả về các hàng (hoặc đích xuất) khi sẵn sàng |
operational_insights_discard_async_query_results | Giải phóng kết quả của truy vấn bất đồng bộ đã hoàn tất |
operational_insights_cancel_async_query | Dừng truy vấn bất đồng bộ vẫn đang chạy (được phép trong chế độ chỉ đọc) |
operational_insights_create_index ✏️ | Tạo chỉ mục phụ thông qua CREATE INDEX |
Truy vấn bất đồng bộ tuân theo quy trình bắt đầu → thăm dò → loại bỏ hoặc hủy: operational_insights_run_query_async trả về query_handle, operational_insights_get_async_query_results được thăm dò cho đến khi sẵn sàng, sau đó operational_insights_discard_async_query_results giải phóng kết quả, hoặc operational_insights_cancel_async_query dừng truy vấn vẫn đang chạy.
Xuất kết quả lớn
Thay vì trả về các hàng, operational_insights_run_query_sync và operational_insights_run_query_async có thể bọc câu lệnh trong COPY ... TO và ghi các hàng vào bộ lưu trữ đối tượng bên ngoài. Truyền đủ cả ba giá trị copy_to_link (một liên kết hiện có được tạo bằng CREATE LINK ... TYPE S3), copy_to_bucket và copy_to_path, cùng với copy_to_format nếu muốn (json, mặc định, hoặc parquet). Sau đó, công cụ trả về xác nhận mà không có hàng:
{
"success": true,
"exported": true,
"destination": {"link": "s3Link", "bucket": "my-exports", "path": "exports/run1", "format": "json"},
"message": "Results were written to my-exports/exports/run1 as json. ..."
}
- Đích không đầy đủ sẽ bị từ chối thay vì âm thầm trả về các hàng.
- Công cụ đồng bộ chờ toàn bộ quá trình tải lên; nên dùng công cụ bất đồng bộ cho các lần xuất lớn.
- Không thể xuất trong chế độ chỉ đọc (vì thao tác này ghi vào bộ lưu trữ bên ngoài), do đó cần
CB_MCP_READ_ONLY_MODE=falsehoặc token cócouchbase-mcp:write. - Không cung cấp
csv, vì công cụ này cần lược đồ đầu ra tường minh mà không thể suy luận từ mộtSELECTbất kỳ.
Cấu hình chung
Các thiết lập này hoạt động giống nhau trên cả hai máy chủ. Có thể đặt mỗi tùy chọn dưới dạng biến môi trường hoặc cờ CLI sau lệnh con.
Kiểm soát an toàn
Tuân theo các nguyên tắc bảo mật sau:
- Cấp cho người dùng cơ sở dữ liệu quyền tối thiểu cần thiết — RBAC là ranh giới kiểm soát có thẩm quyền (xem bên dưới).
- Chỉ cung cấp những công cụ mà tác nhân cần và tắt các công cụ còn lại — mọi công cụ được tải đều có thể được LLM gọi. Dùng chế độ chỉ đọc và
CB_MCP_DISABLED_TOOLSđể giữ danh sách công cụ ở mức tối thiểu. - Yêu cầu xác nhận đối với các công cụ nhạy cảm mà bạn giữ lại — xem Yêu cầu xác nhận.
Các biện pháp kiểm soát dưới đây tạo thành ba lớp, từ phạm vi rộng nhất đến hẹp nhất. Hãy kết hợp chúng — nhưng nhớ rằng không biện pháp nào thay thế được RBAC.
[!IMPORTANT] Quyền RBAC của người dùng cơ sở dữ liệu là biện pháp kiểm soát bảo mật có thẩm quyền. Ví dụ, việc tắt
upsert_document_by_idvàdelete_document_by_idkhông ngănrun_sql_plus_plus_querychạyINSERT/UPDATE/DELETE/MERGE— chỉ chế độ chỉ đọc hoặc việc thiếu quyền RBAC mới ngăn được. Chỉ cấp cho người dùng cơ sở dữ liệu của máy chủ những quyền cần thiết.
Chế độ chỉ đọc
CB_MCP_READ_ONLY_MODE (mặc định là true) là công tắc duy nhất để kiểm soát thao tác ghi:
true— các công cụ ghi được đánh dấu ✏️ trong danh sách công cụ của từng máy chủ không được tải, và các truy vấn sửa đổi dữ liệu hoặc cấu trúc sẽ bị chặn.false— các công cụ ghi được tải và cho phép truy vấn sửa đổi.
Tắt công cụ
CB_MCP_DISABLED_TOOLS loại bỏ hoàn toàn các công cụ khỏi danh sách khám phá. Tùy chọn này chấp nhận danh sách phân tách bằng dấu phẩy hoặc đường dẫn đến tệp có một tên công cụ trên mỗi dòng (# bắt đầu một chú thích):
CB_MCP_DISABLED_TOOLS="upsert_document_by_id,delete_document_by_id"
# or
CB_MCP_DISABLED_TOOLS=/path/to/disabled_tools.txt
# disabled_tools.txt
# Write operations
upsert_document_by_id
delete_document_by_id
# Index advisor
get_index_advisor_recommendations
Trên Capella, máy chủ vận hành cũng tự động tắt một số công cụ quản trị.
Yêu cầu xác nhận (elicitation)
CB_MCP_CONFIRMATION_REQUIRED_TOOLS yêu cầu người dùng xác nhận trước khi chạy công cụ được liệt kê, bằng MCP elicitation. Tùy chọn này chấp nhận cùng định dạng danh sách phân tách bằng dấu phẩy hoặc tệp như danh sách công cụ bị tắt:
CB_MCP_CONFIRMATION_REQUIRED_TOOLS="delete_document_by_id,replace_document_by_id"
- Nếu client hỗ trợ elicitation, người dùng sẽ được nhắc xác nhận trước khi công cụ chạy.
- Nếu không, công cụ sẽ chạy mà không cần xác nhận để tương thích ngược.
- Xác nhận cần có phiên MCP, vì vậy không thể kết hợp với HTTP không trạng thái (
CB_MCP_STATELESS_HTTP=truehoặcCB_MCP_WORKERSlớn hơn 1). Máy chủ sẽ từ chối khởi động với tổ hợp này. Khi chạy sau bộ cân bằng tải, xác nhận cần các phiên cố định — xem Bộ cân bằng tải.
Giao thức truyền tải
| Giao thức truyền tải | Dùng cho | Endpoint |
|---|---|---|
stdio (mặc định) | Một client cục bộ khởi chạy máy chủ dưới dạng tiến trình con | — |
http | Nhiều client dùng chung một máy chủ; hỗ trợ OAuth, kiểm tra tình trạng và worker trên máy chủ vận hành | http://<host>:<port>/mcp |
Đặt giao thức truyền tải bằng CB_MCP_TRANSPORT, địa chỉ bind bằng CB_MCP_HOST (mặc định là 127.0.0.1) và cổng bằng CB_MCP_PORT (cổng mặc định của từng máy chủ nếu không đặt). Nếu không có OAuth, endpoint HTTP không yêu cầu xác thực.
uvx couchbase-mcp-server operational \
--connection-string='<couchbase_connection_string>' \
--username='<database_username>' \
--password='<database_password>' \
--transport=http
Sau đó, trỏ client của bạn đến URL:
{
"mcpServers": {
"couchbase-http": {
"url": "http://localhost:8000/mcp"
}
}
}
Nhiều worker
Một tiến trình sử dụng tối đa khoảng một lõi CPU. --workers N (CB_MCP_WORKERS) chạy N tiến trình trên cùng một máy chủ và cổng; số lõi khả dụng là điểm khởi đầu phù hợp. Chỉ máy chủ vận hành hỗ trợ worker. Khi có nhiều hơn một worker:
- Bắt buộc dùng giao thức truyền tải
http, và máy chủ chạy ở chế độ HTTP không trạng thái vì các yêu cầu của client có thể được chuyển đến các worker khác nhau. Bạn cũng có thể đặt--stateless-http=truetrên một worker duy nhất, chẳng hạn khi chạy sau bộ cân bằng tải không có phiên cố định. - Không thể dùng các công cụ yêu cầu xác nhận.
- Mỗi tiến trình ghi các tệp nhật ký riêng, được đặt tên theo máy chủ và ID tiến trình (
mcp_server.<host>.<pid>.info.log) — một bộ cho tiến trình giám sát và một bộ cho mỗi worker.
Bộ cân bằng tải
Bạn có thể chạy nhiều phiên bản máy chủ phía sau một bộ cân bằng tải. Mỗi phiên bản lưu các phiên MCP trong bộ nhớ riêng, vì vậy thiết lập bộ cân bằng tải sẽ quyết định những gì có thể hoạt động:
| Bộ cân bằng tải | Thiết lập máy chủ | Công cụ yêu cầu xác nhận |
|---|---|---|
Phiên cố định, định tuyến theo header yêu cầu Mcp-Session-Id | Một worker, có trạng thái (mặc định) | Được hỗ trợ |
| Không có phiên cố định | --stateless-http=true | Không được hỗ trợ — máy chủ từ chối khởi động nếu các công cụ này được cấu hình |
- Khi không có phiên cố định, một phiên bản có trạng thái sẽ từ chối mọi yêu cầu có phiên được tạo trên phiên bản khác. Trong trường hợp đó, hãy dùng chế độ không trạng thái.
- Định tuyến theo header
Mcp-Session-Id, không dùng cookie. Nhiều client MCP không lưu cookie. - Nếu một phiên bản khởi động lại hoặc chuyển đổi dự phòng, các phiên và mọi lời nhắc xác nhận đang chờ của phiên bản đó sẽ bị mất. Client phải bắt đầu phiên mới.
- Các truy vấn bất đồng bộ của Operational Insights lưu
query_handletrong bộ nhớ của phiên bản đã bắt đầu truy vấn, kể cả ở chế độ không trạng thái. Việc thăm dò, loại bỏ hoặc hủy truy vấn trên một phiên bản khác sẽ trả vềUnknown query_handle. Hãy dùng các công cụ này với một phiên bản duy nhất hoặc với phiên cố định để mọi lệnh gọi đều đến phiên bản đã bắt đầu truy vấn. Chế độ không trạng thái không gửiMcp-Session-Id, vì vậy cần một khóa liên kết khác, chẳng hạn địa chỉ IP của client.
Kiểm tra tình trạng
Ở chế độ HTTP, GET /health trả về {"status": "ok", "server": "<server>"} trên cổng MCP. Đây là kiểm tra khả năng hoạt động: không kết nối đến cụm (vì vậy sự cố cụm sẽ không khiến các container khỏe mạnh bị khởi động lại), không cần xác thực ngay cả khi bật OAuth và được phục vụ bởi mọi worker. Xem Docker để biết ví dụ về probe.
Ủy quyền OAuth 2.1
Với --transport=http, mỗi máy chủ có thể hoạt động như một máy chủ tài nguyên OAuth 2.1, xác thực JWT bearer dựa trên JWKS của nhà cung cấp danh tính. Cơ chế này hoạt động với mọi nhà cung cấp OAuth 2.1/OIDC công bố JWKS và không cấp token hay quản lý người dùng. Các thiết lập OAuth bị bỏ qua trên stdio.
- OAuth chỉ được bật khi cả ba giá trị
CB_MCP_OAUTH_JWT_JWKS_URI,CB_MCP_OAUTH_JWT_ISSUERvàCB_MCP_OAUTH_JWT_AUDIENCEđều được đặt; nếu chỉ đặt một số giá trị, máy chủ sẽ không khởi động. CB_MCP_OAUTH_MCP_BASE_URLcũng công bố Protected Resource Metadata theo RFC 9728 để client có thể tìm máy chủ ủy quyền.- Quyền truy cập được kiểm soát bằng hai scope trong claim
scope/scpcủa token:couchbase-mcp:read(công cụ đọc) vàcouchbase-mcp:write(công cụ ghi). Để có toàn quyền truy cập, cần cả hai. Đổi tên chúng bằngCB_MCP_OAUTH_SCOPE_READ_LABEL/CB_MCP_OAUTH_SCOPE_WRITE_LABELnếu IdP của bạn không thể phát ra các nhãn này. Cả hai máy chủ dùng chung các nhãn, vì vậy một cấu hình IdP áp dụng cho cả hai.
uvx couchbase-mcp-server operational \
--connection-string='<couchbase_connection_string>' \
--username='<database_username>' \
--password='<database_password>' \
--transport=http \
--oauth-jwks-uri='https://auth.example.com/.well-known/jwks.json' \
--oauth-issuer='https://auth.example.com/' \
--oauth-audience='couchbase-mcp-server' \
--oauth-mcp-base-url='<public_base_url_of_this_server>'
Xem tài liệu OAuth cho máy chủ vận hành và máy chủ Operational Insights để biết cách thiết lập IdP.
Ghi nhật ký
Theo mặc định, mỗi máy chủ ghi nhật ký vào stderr ở cấp độ info.
CB_MCP_LOG_LEVEL—off,error,warning,info(sự kiện vòng đời và lệnh gọi công cụ) hoặcdebug.CB_MCP_LOG_SINKS—stderr,file, hoặc cả hai. Vớifile, một tệp xoay vòng cho mỗi cấp độ được ghi bên cạnhCB_MCP_LOG_FILE(mcp_server.info.log,mcp_server.error.log, …).- Xoay vòng và lưu giữ —
CB_MCP_LOG_ROTATION_MAX_SIZE_MB(mặc định 1 MB) vàCB_MCP_LOG_RETENTION_BACKUP_COUNT(mặc định 1) áp dụng cho mọi cấp độ; ghi đè theo từng cấp độ bằngCB_MCP_LOG_<LEVEL>_ROTATION_MAX_SIZE_MB/CB_MCP_LOG_<LEVEL>_RETENTION_BACKUP_COUNT. Kích thước không hợp lệ sẽ dùng giá trị mặc định và đưa ra cảnh báo khi khởi động.CB_MCP_LOG_MAX_BYTESđã lỗi thời. - Ảnh chụp cấu hình — với sink
file, một bản ghi JSON về môi trường và cấu hình máy chủ đã được biên tập sẽ được ghi vàomcp_server_config.log.jsonmỗi khi khởi động để hỗ trợ xử lý sự cố.
# Debug logging to stderr and rotating per-level files
uvx couchbase-mcp-server operational --log-level=debug --log-sinks=stderr,file
Ứng dụng MCP của bạn thường cũng thu thập stderr của máy chủ — xem Thiết lập ứng dụng khách để biết vị trí. Chi tiết: tài liệu ghi nhật ký cho máy chủ vận hành và máy chủ Operational Insights.
Kiểm tra nhật ký
Ghi nhật ký kiểm tra lưu lại ai đã làm gì và việc đó có được cho phép hay không — tách biệt với nhật ký vận hành, vốn ghi lại những gì đã xảy ra lỗi. Máy chủ MCP là lớp duy nhất có thể trả lời câu hỏi này đối với một tác nhân: mọi yêu cầu đều đến cụm dưới dạng một người dùng cơ sở dữ liệu duy nhất, còn các quyết định như từ chối phạm vi, chặn chỉ đọc hoặc từ chối xác nhận thì không bao giờ đến được cụm.
Ghi nhật ký kiểm tra mặc định tắt. Bật bằng CB_MCP_AUDIT_LOG_ENABLED=true; nhật ký được ghi vào stderr, trừ khi bạn đặt CB_MCP_AUDIT_LOG_SINKS=file và CB_MCP_AUDIT_LOG_FILE_PATH.
# 90 days of daily, gzipped audit files
uvx couchbase-mcp-server operational --audit-log-enabled=true \
--audit-log-sinks=file --audit-log-file-path=/var/log/cb-mcp/audit.log \
--audit-log-rotation-interval=1d --audit-log-rotation-max-size-mb=0 \
--audit-log-retention-max-backups=90
Các bản ghi dùng định dạng JSON Lines với cùng hệ thống trường như Couchbase Server và Sync Gateway:
{"id":61522,"name":"document write","description":"A document write operation was requested through a tool","timestamp":"2026-09-29T09:14:22.418Z","real_userid":{"domain":"oauth","user":"agent-svc-7"},"server":{"version":"1.0.2","host":"mcp-01"},"cid":"9f2c...","outcome":"success","tool_name":"upsert_document_by_id","required_scope":"write","ks":"travel-sample.inventory.airline","cb_userid":"mcp_service"}
Cách thức hoạt động của ghi nhật ký kiểm tra
- Danh tính —
real_useridlà bên gọi:oauth(chủ thể của token),local(người dùng hệ điều hành, trên stdio) hoặcanonymous(HTTP không có OAuth, sẽ đưa ra cảnh báo khi khởi động). - Tương quan —
cidnhóm mọi bản ghi từ một yêu cầu và được gửi dưới dạngclient_context_idcủa SQL++, nhờ đó khớp chính xác vớiclientContextIdcủa Couchbase Server. Cố ý không có mã định danh phiên. - Sự kiện — danh mục cố định, được đánh số (vòng đời, khởi tạo, token bị từ chối, phạm vi bị từ chối, chặn chỉ đọc, xác nhận bị từ chối/bỏ qua và một cặp đọc/ghi cho mỗi danh mục công cụ).
queryvàsearchlà ngoại lệ: mỗi mục được ghi thành một sự kiện duy nhất thay vì một cặp đọc/ghi, vì không thể phân biệt một cách đáng tin cậy đối với các bề mặt dựa trên câu lệnh và tìm kiếm. Các thao tác vector thuộc hai danh mục đó. Danh mục đầy đủ được đóng gói dưới dạngdescriptor.json. Máy chủ vận hành dùng khối0xF000(61440), Operational Insights dùng0x10000(65536), và cả hai dùng chung0xE000(57344) cho các sự kiện cốt lõi. - Lọc —
CB_MCP_AUDIT_LOG_DISABLED_EVENTSloại bỏ các sự kiện đọc theo mã số (ví dụ:61490,61492). Không thể tắt các sự kiện ghi và bảo mật, cũng như các danh mục chỉ có một sự kiệnquery(61507, hoặc 65603 trên Operational Insights) vàsearch(61510): mỗi sự kiện bao quát cả thao tác ghi lẫn đọc của danh mục đó, nên tắt sự kiện sẽ làm mất bản ghi về thao tác thay đổi. - Xoay vòng — theo kích thước (
CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB, mặc định 10) và thời gian (CB_MCP_AUDIT_LOG_ROTATION_INTERVAL, mặc định1d), tùy điều kiện nào đến trước;0sẽ tắt một trong hai. Các tệp đã xoay vòng được gắn dấu thời gian và nén bằng gzip; tệp hiện hành vẫn là văn bản thuần đểtail -f. - Tệp riêng cho từng tiến trình — máy chủ và pid được chèn vào tên (
audit.log→audit.<host>.<pid>.log), vì vậy các tiến trình chạy đồng thời không bao giờ dùng chung một tệp. - Lưu giữ theo từng tệp —
CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS(mặc định 10) giới hạn số bản sao lưu của một tệp. Mỗi tiến trình mới ghi vào một tệp mới và không xóa các tệp cũ, vì vậy hãy cấp dung lượng phù hợp cho ổ đĩa hoặc dọn các tệpaudit.*.log*cũ. - Tiếp tục hoạt động khi lỗi — nếu không thể ghi tệp, máy chủ vẫn tiếp tục phục vụ và đếm số bản ghi bị mất;
get_server_configuration_statusbáo cáowritten/dropped/write_errors. - Đối số công cụ — chỉ được ghi khi có
CB_MCP_AUDIT_LOG_TOOL_ARGS=true, tùy chọn này sẽ đưa ra cảnh báo khi khởi động. Bản phát hành này không có chức năng biên tập, vì vậy các đối số, bao gồm toàn bộ nội dung tài liệu, được ghi nguyên văn.
Thiết lập ứng dụng khách
Mỗi ứng dụng khách cần cấu hình máy chủ từ hướng dẫn bắt đầu nhanh của máy chủ vận hành hoặc máy chủ Operational Insights tại vị trí cấu hình riêng. Các ví dụ dưới đây dùng máy chủ vận hành.
Claude Desktop
- Mở tệp cấu hình (xem hướng dẫn bắt đầu nhanh MCP):
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
- Thêm máy chủ bên dưới
mcpServersrồi khởi động lại Claude Desktop.
Nhật ký: macOS ~/Library/Logs/Claude, Windows %APPDATA%\Claude\Logs. Xem hướng dẫn khắc phục sự cố MCP.
Cursor
- Vào Cursor Settings > Tools & Integrations > MCP Tools (xem tài liệu MCP của Cursor), hoặc dùng liên kết Cài đặt trong Cursor chỉ bằng một cú nhấp — sau đó thay chuỗi kết nối và thông tin xác thực mẫu.
- Thêm cấu hình bên dưới
mcpServersrồi lưu. - Làm mới danh sách máy chủ MCP để kiểm tra
couchbaseđã được bật.
Nhật ký: trong bảng điều khiển phía dưới, mở Output và chọn Cursor MCP.
Windsurf Editor
- Mở Command Palette > Windsurf MCP Configuration Panel, hoặc Windsurf Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers (xem tài liệu MCP của Windsurf).
- Nhấp Add Server > Add custom server, dán cấu hình rồi lưu.
- Làm mới danh sách máy chủ để kiểm tra
couchbaseđã được bật.
VS Code
VS Code dùng servers làm khóa cấp cao nhất thay vì mcpServers. Đặt cấu hình trong .vscode/mcp.json cho một không gian làm việc, hoặc chạy MCP: Open User Configuration để áp dụng cho mọi không gian làm việc (xem tài liệu MCP của VS Code):
{
"servers": {
"couchbase": {
"command": "uvx",
"args": ["couchbase-mcp-server", "operational"],
"env": {
"CB_CONNECTION_STRING": "couchbases://connection-string",
"CB_USERNAME": "username",
"CB_PASSWORD": "password"
}
}
}
}
Lưu tệp sẽ khởi động máy chủ; dùng các thao tác Running | Stop | n Tools phía trên để quản lý máy chủ.
Nhật ký: chạy MCP: List Servers, chọn couchbase, rồi chọn Show Output.
JetBrains IDEs
- Cài plugin AI Assistant hoặc Junie.
- Vào Settings > Tools > AI Assistant (or Junie) > MCP Server, nhấp +, thêm cấu hình rồi nhấp Apply.
- Di chuột lên trạng thái máy chủ để xem các công cụ của máy chủ.
Nhật ký: Help > Show Log in Finder (Explorer) > mcp > couchbase.
Docker
Các image dựng sẵn được phát hành lên Docker Hub dưới tên couchbase/mcp-server, và máy chủ được liệt kê trong Docker MCP Catalog. Cấu hình container bằng các biến môi trường như trên. Xem trang Docker Hub (DOCKER.md) để biết ví dụ về tag, volume và kiểm tra tình trạng hoạt động.
Chạy qua HTTP — lưu ý máy chủ phải bind vào 0.0.0.0 để có thể truy cập từ bên ngoài container:
docker run --rm \
-e CB_CONNECTION_STRING='<couchbase_connection_string>' \
-e CB_USERNAME='<database_user>' \
-e CB_PASSWORD='<database_password>' \
-e CB_MCP_TRANSPORT=http \
-e CB_MCP_HOST=0.0.0.0 \
-p 8000:8000 \
couchbase/mcp-server:latest operational
- Nếu Couchbase chạy trên máy chủ của bạn, hãy dùng
couchbase://host.docker.internallàm chuỗi kết nối (xem kết nối mạng Docker). Dùng--network=<your_network>để tham gia mạng của một container khác. - Thêm
operational-insightsthay chooperationalđể chạy máy chủ Operational Insights (cổng8001).
Dựng image từ mã nguồn
docker build -t mcp/couchbase-src .
./build.sh [image-name] dựng image với cùng các đối số như CI — lệnh này đặt các đối số dựng GIT_COMMIT_HASH và BUILD_DATE, đồng thời gắn tag cho image là latest và <short-commit> (tên mặc định mcp/couchbase-src). Để tự dựng với các nhãn:
docker build --build-arg GIT_COMMIT_HASH=$(git rev-parse HEAD) \
--build-arg BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ') \
-t mcp/couchbase-src .
# Check the labels
docker inspect --format='{{json .Config.Labels}}' mcp/couchbase-src:latest
Khắc phục sự cố
Để xem hướng dẫn đầy đủ, hãy tham khảo tài liệu khắc phục sự cố cho máy chủ vận hành và máy chủ Operational Insights, cùng hướng dẫn bảo mật cho máy chủ vận hành và máy chủ Operational Insights. Các bước kiểm tra nhanh:
- Kiểm tra chuỗi kết nối, tên người dùng/mật khẩu hoặc đường dẫn chứng chỉ.
- Với Capella, hãy đảm bảo cụm cho phép kết nối từ máy đang chạy máy chủ.
- Đảm bảo người dùng cơ sở dữ liệu có thể truy cập ít nhất một bucket.
- Nếu ứng dụng khách không tìm thấy
uv/uvx, hãy đặt đường dẫn tuyệt đối trongcommand. - Khi chạy từ mã nguồn, hãy kiểm tra đường dẫn kho lưu trữ trong cấu hình và chạy
uv syncsau khi kéo các bản cập nhật. - Gọi
get_server_configuration_statusđể xem cấu hình mà máy chủ thực sự đã phân giải, đồng thời kiểm tra nhật ký của ứng dụng khách (xem Thiết lập ứng dụng khách).
Câu hỏi thường gặp
Làm cách nào để kết nối Claude Desktop với Couchbase? Thêm cấu hình bắt đầu nhanh vào claude_desktop_config.json rồi khởi động lại Claude Desktop — xem Thiết lập ứng dụng khách.
Tôi có thể dùng ứng dụng này với Couchbase Capella không? Có, với máy chủ vận hành: cùng một cấu hình dùng được cho Capella và các cụm tự quản lý, dù một số công cụ quản trị chỉ có trên các cụm tự quản lý (xem Công cụ). Máy chủ Operational Insights chỉ dành cho các cụm Operational Insights tự quản lý.
Cho phép tác nhân AI ghi vào cơ sở dữ liệu có an toàn không? Theo mặc định là không: không có công cụ ghi nào được tải và các câu lệnh SQL++ sửa đổi bị chặn. Nếu bật chức năng ghi, bạn vẫn có thể tắt từng công cụ hoặc yêu cầu xác nhận — nhưng quyền RBAC của người dùng Couchbase vẫn là ranh giới bảo mật thực sự. Xem Kiểm soát an toàn.
Tôi có cần biết SQL++ không? Không. Hãy hỏi bằng ngôn ngữ thông thường, trợ lý sẽ viết SQL++ cho run_sql_plus_plus_query. Trợ lý cũng có thể giải thích kế hoạch truy vấn hoặc yêu cầu Index Advisor đưa ra đề xuất.
STDIO hay Streamable HTTP? Dùng STDIO cho một ứng dụng khách cục bộ. Dùng Streamable HTTP để chia sẻ một máy chủ giữa nhiều ứng dụng khách, với OAuth. Xem Giao thức truyền tải.
Couchbase có chính thức hỗ trợ ứng dụng này không? Có, nếu có giấy phép Couchbase AI Data Plane. Nếu không có giấy phép, các kỹ sư Couchbase sẽ hỗ trợ theo khả năng thông qua các vấn đề trên GitHub. Xem Chính sách hỗ trợ.
Đóng góp
Chúng tôi hoan nghênh các đóng góp — sửa lỗi, tính năng và tài liệu. Để báo lỗi hoặc yêu cầu trợ giúp, hãy mở vấn đề trên GitHub.
Xem CONTRIBUTING.md để biết cách thiết lập môi trường phát triển, lint, kiểm thử, cấu trúc dự án và quy trình làm việc. Bắt đầu như sau:
git clone https://github.com/couchbase/mcp-server-couchbase.git
cd mcp-server-couchbase
uv sync --extra dev
uv run pre-commit install
./scripts/lint.sh
Kiểm thử tích hợp chạy trên một cụm đang hoạt động. Xuất CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD và tùy chọn CB_MCP_TEST_BUCKET; các bài kiểm thử Operational Insights cũng dùng CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING / _USERNAME / _PASSWORD và sẽ bị bỏ qua nếu các biến này chưa được đặt. Sau đó chạy:
uv run --extra dev pytest tests/integration -v
Dữ liệu sử dụng, rủi ro LLM và chính sách hỗ trợ
Thu thập dữ liệu sử dụng
Sản phẩm này tự động thu thập dữ liệu về mức sử dụng và hiệu suất (chẳng hạn như tên và phiên bản sản phẩm) cùng thông tin trình duyệt (chẳng hạn như địa chỉ IP) (gọi chung là "Dữ liệu sử dụng"). Couchbase sử dụng Dữ liệu sử dụng cùng với các dữ liệu khác mà bạn có thể cung cấp cho Couchbase (chẳng hạn như tên người dùng hoặc địa chỉ email) để phát triển và cải thiện sản phẩm, đồng thời hỗ trợ các chương trình bán hàng và tiếp thị. Chúng tôi không truy cập hoặc thu thập bất kỳ dữ liệu nào bạn lưu trữ trong các sản phẩm Couchbase. Chúng tôi sử dụng Dữ liệu sử dụng để hiểu các kiểu sử dụng tổng thể và giúp sản phẩm hữu ích hơn cho bạn. Để biết thêm thông tin về cách Couchbase thu thập, bảo vệ và xử lý thông tin, vui lòng tham khảo Chính sách quyền riêng tư của Couchbase tại https://www.couchbase.com/privacy-policy.
Rủi ro liên quan đến LLM
- Việc sử dụng các mô hình ngôn ngữ lớn và công nghệ tương tự tiềm ẩn rủi ro, bao gồm khả năng tạo ra kết quả không chính xác hoặc có hại.
- Couchbase không xem xét hoặc đánh giá chất lượng hay độ chính xác của những kết quả đó, và chúng có thể không phản ánh quan điểm của Couchbase.
- Bạn hoàn toàn chịu trách nhiệm quyết định có sử dụng mô hình ngôn ngữ lớn và công nghệ liên quan hay không, cũng như tuân thủ mọi điều khoản cấp phép, điều khoản sử dụng và chính sách của tổ chức chi phối việc sử dụng các công nghệ này.
Chính sách hỗ trợ
Couchbase MCP Server là mã nguồn mở và được các kỹ sư Couchbase duy trì. Cách bạn nhận trợ giúp tùy thuộc vào cách bạn sử dụng sản phẩm:
- Sử dụng cộng đồng — báo cáo lỗi, đặt câu hỏi và yêu cầu tính năng bằng cách mở vấn đề trên GitHub. Các kỹ sư Couchbase theo dõi kho lưu trữ và phản hồi trong khả năng tốt nhất, nhưng không cam kết thời gian phản hồi. Cổng hỗ trợ Couchbase không thể trợ giúp cho việc sử dụng cộng đồng.
- Hỗ trợ doanh nghiệp — có sẵn khi cấp phép Couchbase AI Data Plane, gói này cũng bao gồm Couchbase Agent Memory và Couchbase Agent Catalog. Khách hàng có giấy phép nhận hỗ trợ thông qua các kênh Couchbase Support thông thường.
Cảm ơn bạn đã sử dụng và đóng góp cho dự án!