Couchbase MCP Server

Couchbase MCP 服务

Couchbase MCP 服务是一个可自托管的 Model Context Protocol (MCP) 服务，可将 AI Agent 和助手——Claude、Cursor、Windsurf、VS Code Copilot、JetBrains AI Assistant 以及任何其他 MCP 客户端——连接到 Couchbase Server 集群中的数据，无论集群部署在 Capella 上还是由您自行管理，也可连接到自行管理的 Operational Insights 集群。Agent 可以检查您的集群、探索架构、运行 SQL++、全文和向量查询、读取和写入文档，并使用自然语言诊断查询和集群性能问题。

默认情况下，它为只读模式，支持 STDIO 和 Streamable HTTP（采用 OAuth 2.1），并通过 PyPI 和 Docker Hub 分发。获得企业支持需获得 Couchbase AI Data Plane 许可；该许可还包含 Couchbase Agent Memory 和 Couchbase Agent Catalog 的使用权限及企业支持。

Full documentation: docs.couchbase.com/mcp-server

目录

• 为什么选择 Couchbase MCP Server
• 选择服务
• 运维服务
  • 快速入门
  • 连接与身份验证
  • 工具
  • 嵌入提供方
  • 所有选项
• 运维洞察服务
  • 快速入门
  • 连接与身份验证
  • 工具
  • 导出大型结果
• 通用配置
  • 安全控制
  • 传输方式
  • OAuth 2.1 授权
  • 日志记录
  • 审计
• 客户端设置
• Docker
• 故障排除
• 常见问题
• 贡献
• 使用数据、大模型风险与支持政策

为什么选择 Couchbase MCP Server

• 默认安全 — 默认不会加载写入工具，并且会阻止修改数据的查询，除非设置 CB_MCP_READ_ONLY_MODE=false；也可以禁用单个工具，或要求用户确认后才能使用。
• Couchbase Server 和 Operational Insights — 运维服务 使用相同配置连接到 Couchbase Capella 或自托管的 Couchbase Server 集群；Operational Insights 服务 连接到自托管的 Operational Insights 集群。
• 遵循 RBAC — 工具控制会引导大模型；Couchbase 用户的基于角色的访问控制仍是权威的安全边界。
• 面向生产环境的传输方式 — 可通过 STDIO 连接本地桌面客户端，也可使用支持可选 OAuth 2.1 的 Streamable HTTP（适用于任何发布 JWKS 的 IdP：Auth0、Okta、Keycloak、Entra、Cognito 等），并支持运行状况检查和审计日志，适用于共享部署。运维服务还可以运行多个工作进程，以使用更多 CPU 核心。
• 适用于任何 MCP 客户端 — 已通过 Claude Desktop、Cursor、Windsurf、VS Code 和 JetBrains AI Assistant/Junie 测试。

连接后，你可以提出如下问题：

• “我有哪些存储桶、作用域和集合，orders 集合的架构是什么？”
• “在 users 中查找最近的 10 个 status = 'active' 的文档。”
• “过去一小时内最慢的 5 个查询是什么？其中有没有缺少覆盖索引的？”
• “此集群是否运行正常，当前运行着哪些服务？”
• “在 products 中插入一个包含以下字段的新文档：……”（需要设置 CB_MCP_READ_ONLY_MODE=false）

选择服务

此软件包提供两个 MCP 服务。每个服务都通过自己的子命令启动，连接到不同类型的集群，并提供各自的工具。请选择与您的集群相匹配的服务，按照对应章节完成设置并了解工具，然后参阅通用配置了解两者共用的设置。若要同时使用两者，请在 MCP 客户端中将它们分别注册为独立服务。

目前，operational 服务可以不指定子命令——直接运行 couchbase-mcp-server 即可启动该服务——但明确指定子命令可让配置更清晰。选项应放在子命令之后：couchbase-mcp-server operational --transport=http。使用 uvx couchbase-mcp-server --version 检查已安装的版本。

Operational 服务

operational 服务使用 couchbase Python SDK 连接 Capella 上的 Couchbase 集群或自托管的 Couchbase Server。

Operational 快速入门

您需要一个正在运行的 Couchbase 集群——Capella 免费套餐是最快捷的选择（您可以导入示例数据集）——以及一个 MCP 客户端。将以下配置中的一项添加到您的客户端（各客户端的配置位置请参阅客户端设置）。如果客户端已配置其他服务，请将 couchbase 添加到现有的 mcpServers 对象中。

通过 PyPI 使用 uvx（需要 uv 和 Python 3.11+）：

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server", "operational"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

使用 Docker（仅需 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"
      ]
    }
  }
}

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"
      }
    }
  }
}

Operational 连接与身份验证

请使用用户名和密码或客户端证书（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"
      }
    }
  }
}

Operational 工具

在只读模式开启时（默认状态），写入工具（标记为 ✏️）不会加载。标记为 🖥️ 的工具使用 Capella 未公开的管理 REST 端点：这些工具需要自托管的 Couchbase Server 7.6+，且不会在 Capella 连接上注册。

集群设置和运行状况

数据模型和架构发现

文档（KV）操作

查询和索引

全文搜索（FTS）

需要 Couchbase Server 7.6+ 和 Search 服务。支持作用域级索引和集群级（旧版）索引：同时传入 bucket_name 和 scope_name 表示作用域级索引，或同时省略二者。

向量搜索

这两个工具都会使用 Embedding Providers 中配置的模型，将纯文本查询转换为向量。适用于自托管的 Couchbase Server 和 Capella。

查询性能分析

查询服务运行状况 🖥️

这些工具会在每个查询节点上调用 Query 服务自身的管理 REST API。

在 Capella 上自动禁用的工具

🖥️ 工具通过管理 REST 端点访问 Couchbase，而 Capella 不会公开这些端点。当 CB_CONNECTION_STRING 中的每个主机都以 .cloud.couchbase.com 结尾时，服务器不会注册这些工具，并会在 get_server_configuration_status 和启动日志中将它们与您自己的已禁用工具一并报告。基于 SDK 的工具（例如 get_cluster_health_and_services 和 get_client_connectivity_report）仍可使用。

嵌入提供商

run_vector_query 和 run_vector_search 使用 CB_MCP_EMBEDDING_MODEL_PROVIDER 中设置的提供商来嵌入查询文本。此设置为可选项：未设置时，服务会正常启动，两个工具也会保持注册状态，但调用时会返回错误，说明需要设置什么。

"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-..."
}

所有选项

Operational Insights 服务

operational-insights 服务连接到自管理的 Operational Insights 集群。Operational Insights 是一个面向实时应用和运营智能的实时分析数据库（RT-OLAP）。该服务不适用于 Capella。它使用 couchbase-operational-insights SDK。它作为独立进程运行，与运营服务分开。

重要

CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING 是一个 HTTP(S) URL，不是 couchbase:// 连接字符串，例如 http://localhost:8095，或通过 TLS 使用的 https://<host>:18095。这是最常见的配置错误。

Operational Insights 快速入门

通过 PyPI 使用 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"
      }
    }
  }
}

使用 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"
      ]
    }
  }
}

从源代码运行时，请使用运营源代码配置，将 operational-insights 作为最后一个参数，并设置上述变量。

Operational Insights 连接和身份验证

所有通用配置均适用，但与运营服务相比有以下差异：

• 默认端口为 8001，默认日志文件为 mcp_server_operational_insights.log，因此两个服务可以同时运行。
• 仅支持一个工作进程（CB_MCP_WORKERS=1），因为异步查询句柄存储在进程内存中。
• 不提供 CB_MCP_EMBEDDING_MODEL_* 选项。

运维洞察工具

除 get_server_configuration_status 外，所有名称都以 operational_insights_ 为前缀，因此两个服务可以注册到同一个客户端中而不会发生冲突。默认情况下，只读模式开启时，写入工具（标记为 ✏️）不会加载。

异步查询遵循启动 → 轮询 → 丢弃或取消的流程：operational_insights_run_query_async 会返回 query_handle，然后轮询 operational_insights_get_async_query_results，直到结果就绪；接着调用 operational_insights_discard_async_query_results 释放结果，或者调用 operational_insights_cancel_async_query 停止仍在运行的查询。

导出大型结果

operational_insights_run_query_sync 和 operational_insights_run_query_async 可以将语句包装在 COPY ... TO 中，并将行写入外部对象存储，而不是返回行。传入以下三个参数：copy_to_link（使用 CREATE LINK ... TYPE S3 创建的现有链接）、copy_to_bucket 和 copy_to_path；还可以选择传入 copy_to_format（默认值为 json，也可以是 parquet）。随后，工具会返回确认信息，不包含行：

{
  "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. ..."
}

• 如果目标信息不完整，操作会被拒绝，而不会静默地改为返回行。
• 同步工具会等待整个上传完成；大型导出优先使用异步工具。
• 只读模式下会阻止导出（因为导出会写入外部存储），因此需要设置 CB_MCP_READ_ONLY_MODE=false 或使用具有 couchbase-mcp:write 权限的令牌。
• 不提供 csv 格式，因为它需要显式指定输出架构，而该架构无法从任意 SELECT 语句中推断出来。

通用配置

以下设置对两个服务的作用方式相同。每个选项都可以通过环境变量设置，也可以在子命令后作为 CLI 标志传入。

安全控制

共有三层控制，从范围最广到最窄。请结合使用，但请记住，它们都不能替代 RBAC。

重要

数据库用户的 RBAC 权限是权威的安全控制。例如，禁用 upsert_document_by_id 和 delete_document_by_id 并不能阻止 run_sql_plus_plus_query 运行 INSERT/UPDATE/DELETE/MERGE——只有只读模式或缺少 RBAC 权限才能阻止。仅向服务的数据库用户授予其所需的权限。

只读模式

CB_MCP_READ_ONLY_MODE（默认值为 true）是控制写入的唯一开关：

• true — 各服务工具列表中标记为 ✏️ 的写入工具不会加载，并且会阻止修改数据或结构的查询。
• false — 写入工具会加载，允许执行修改查询。

禁用工具

CB_MCP_DISABLED_TOOLS 会将工具从发现列表中完全移除。它接受逗号分隔的列表，或每行一个工具名称的文件路径（# 用于开始注释）：

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

在 Capella 上，运行服务器还会自动禁用部分管理工具。

要求确认（elicitation）

CB_MCP_CONFIRMATION_REQUIRED_TOOLS 会使用 MCP elicitation，要求用户在运行列出的工具前进行确认。它接受与禁用工具相同的逗号分隔列表或文件格式：

CB_MCP_CONFIRMATION_REQUIRED_TOOLS="delete_document_by_id,replace_document_by_id"

• 如果客户端支持 elicitation，系统会在工具运行前提示用户。
• 如果不支持，为保持向后兼容，工具会在未经确认的情况下运行。
• 确认需要 MCP 会话，因此不能与无状态 HTTP（CB_MCP_STATELESS_HTTP=true 或上文所述的 CB_MCP_WORKERS 大于 1）同时使用。服务器会拒绝以这种组合启动。

传输方式

使用 CB_MCP_TRANSPORT 设置传输方式，使用 CB_MCP_HOST 设置绑定地址（默认值为 127.0.0.1），使用 CB_MCP_PORT 设置端口（未设置时使用各服务器的默认端口）。如果没有启用 OAuth，HTTP 端点无需身份验证即可访问。

uvx couchbase-mcp-server operational \
  --connection-string='<couchbase_connection_string>' \
  --username='<database_username>' \
  --password='<database_password>' \
  --transport=http

然后将客户端指向该 URL：

{
  "mcpServers": {
    "couchbase-http": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

多个工作进程

一个进程最多使用约一个 CPU 核心。--workers N（CB_MCP_WORKERS）会在同一主机和端口后运行 N 个进程；可用核心数是一个很好的起始值。只有运行服务器支持工作进程。使用多个工作进程时：

• 必须使用 http 传输方式，并且服务器会以无状态 HTTP 模式运行，因为客户端的请求可能会到达不同的工作进程。单个工作进程也可以设置 --stateless-http=true，例如在不使用粘性会话的负载均衡器后运行时。
• 不能使用需要确认的工具。
• 每个进程都会写入自己的日志文件，文件名包含主机名和进程 ID（mcp_server.<host>.<pid>.info.log）——监督进程一套，每个工作进程各一套。

运行状况检查

在 HTTP 模式下，GET /health 会在 MCP 端口返回 {"status": "ok", "server": "<server>"}。这是存活状态检查：它不会连接集群（因此集群故障不会导致正常运行的容器重启），即使启用了 OAuth 也无需身份验证，并且每个工作进程都能处理该请求。探测示例请参阅 Docker。

OAuth 2.1 授权

使用 --transport=http 时，任一服务器都可以充当 OAuth 2.1 资源服务器，根据身份提供商的 JWKS 验证 Bearer JWT。它适用于任何会发布 JWKS 的 OAuth 2.1/OIDC 提供商，但不会颁发令牌或管理用户。stdio 模式下会忽略 OAuth 设置。

• 仅当 CB_MCP_OAUTH_JWT_JWKS_URI、CB_MCP_OAUTH_JWT_ISSUER 和 CB_MCP_OAUTH_JWT_AUDIENCE 三项均已设置时，才会启用 OAuth；只设置其中部分参数会导致启动失败。
• CB_MCP_OAUTH_MCP_BASE_URL 还会发布 RFC 9728 受保护资源元数据，使客户端能够发现授权服务器。
• 访问权限由令牌的 scope/scp 声明中的两个范围控制：couchbase-mcp:read（读取工具）和 couchbase-mcp:write（写入工具）。完整访问权限需要同时具备两者。如果你的 IdP 无法发出这些标签，请使用 CB_MCP_OAUTH_SCOPE_READ_LABEL / CB_MCP_OAUTH_SCOPE_WRITE_LABEL 重命名它们。两个服务器使用相同的标签，因此一套 IdP 配置即可覆盖两者。

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>'

IdP 设置请参阅 OAuth 文档。

日志记录

每个服务默认以 info 级别将日志写入 stderr。

• CB_MCP_LOG_LEVEL — off、error、warning、info（生命周期事件和工具调用）或 debug。
• CB_MCP_LOG_SINKS — stderr、file，或两者兼用。使用 file 时，每个级别都会写入一个轮换文件，存放在 CB_MCP_LOG_FILE 旁边（mcp_server.info.log、mcp_server.error.log，……）。
• 轮换和保留 — CB_MCP_LOG_ROTATION_MAX_SIZE_MB（默认 1 MB）和 CB_MCP_LOG_RETENTION_BACKUP_COUNT（默认 1）适用于每个级别；可通过 CB_MCP_LOG_<LEVEL>_ROTATION_MAX_SIZE_MB / CB_MCP_LOG_<LEVEL>_RETENTION_BACKUP_COUNT 按级别覆盖。大小无效时会回退到默认值，并在启动时发出警告。CB_MCP_LOG_MAX_BYTES 已弃用。
• 配置快照 — 使用 file 输出时，每次启动都会将环境和经过脱敏的服务配置以 JSON 记录写入 mcp_server_config.log.json，供支持人员查看。

# Debug logging to stderr and rotating per-level files
uvx couchbase-mcp-server operational --log-level=debug --log-sinks=stderr,file

你的 MCP 客户端通常也会捕获服务的 stderr — 请参阅 客户端设置，了解相关位置。详情请见：日志记录文档。

审计

审计日志记录谁做了什么，以及是否获准 — 这与记录出错情况的运维日志相互独立。对于 Agent，只有 MCP 服务这一层能够回答这个问题：每个请求都会以单个数据库用户的身份到达集群，而范围拒绝、只读拦截或确认被拒绝等决定根本不会到达集群。

审计默认关闭。设置 CB_MCP_AUDIT_LOG_ENABLED=true 即可启用；日志会写入 stderr，除非你设置了 CB_MCP_AUDIT_LOG_SINKS=file 和 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

记录采用 JSON Lines 格式，字段词汇与 Couchbase Server 和 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"}

每个客户端都需要在自己的配置位置添加来自操作型或Operational Insights快速入门的服务配置。以下示例使用操作型服务。

{
  "servers": {
    "couchbase": {
      "command": "uvx",
      "args": ["couchbase-mcp-server", "operational"],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password"
      }
    }
  }
}

预构建镜像已发布到 Docker Hub，名称为 couchbase/mcp-server，该服务也已列入 Docker MCP Catalog。使用与上文相同的环境变量配置容器。标签、卷和健康检查示例请参阅 Docker Hub 页面（DOCKER.md）。

通过 HTTP 运行时，请注意：服务必须绑定到 0.0.0.0，才能从容器外部访问：

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

• 如果 Couchbase 在主机上运行，请使用 couchbase://host.docker.internal 作为连接字符串（参阅 Docker 网络）。使用 --network=<your_network> 加入另一个容器所在的网络。
• 将 operational 替换为 operational-insights，即可运行 Operational Insights 服务（端口 8001）。

docker build -t mcp/couchbase-src .

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

故障排除

• 检查连接字符串、用户名/密码或证书路径。
• 对于 Capella，请确保集群允许运行服务的机器连接。
• 确保数据库用户至少可以访问一个存储桶。
• 如果客户端找不到 uv/uvx，请在 command 中填写绝对路径。
• 从源代码运行时，请检查配置中的仓库路径，并在拉取更新后运行 uv sync。
• 调用 get_server_configuration_status，查看服务实际解析出的配置，并检查客户端日志（参阅客户端设置）。

常见问题

如何将 Claude Desktop 连接到 Couchbase？ 将快速入门配置添加到 claude_desktop_config.json，然后重启 Claude Desktop——参阅客户端设置。

可以将它用于 Couchbase Capella 吗？ 可以，使用操作服务即可：相同配置适用于 Capella 和自管理集群，但部分管理工具仅适用于自管理集群（参阅工具）。Operational Insights 服务仅适用于自管理的 Operational Insights 集群。

允许 AI Agent 向我的数据库写入数据安全吗？ 默认情况下，不安全：不会加载写入工具，并且会阻止修改 SQL++。如果启用写入，仍可禁用单个工具或要求确认——但 Couchbase 用户的 RBAC 权限仍是实际的安全边界。参阅安全控制。

我需要了解 SQL++ 吗？ 不需要。只需用自然语言提问，助手就会为 run_sql_plus_plus_query 编写 SQL++。它还可以解释查询计划，或向 Index Advisor 请求建议。

STDIO、Streamable HTTP 还是 SSE？ 单个本地客户端适用 STDIO。多个客户端共享一个服务并使用 OAuth 时，适用 Streamable HTTP。SSE 已弃用。参阅传输方式。

Couchbase 是否官方支持此项目？ 是，需持有 Couchbase AI Data Plane 许可证。没有许可证时，Couchbase 工程师会通过 GitHub issues 尽力提供帮助。参阅支持政策。

贡献

欢迎贡献——包括错误修复、功能和文档。如需报告错误或寻求帮助，请提交 GitHub issue。

开发环境设置、代码检查、测试、项目结构和工作流请参阅 CONTRIBUTING.md。开始贡献：

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

集成测试会连接到运行中的集群。导出 CB_CONNECTION_STRING、CB_USERNAME、CB_PASSWORD，并可选择导出 CB_MCP_TEST_BUCKET；Operational Insights 测试还会使用 CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING / _USERNAME / _PASSWORD，如果未设置这些变量，则会跳过相关测试。然后运行：

uv run --extra dev pytest tests/integration -v

使用数据、大模型风险和支持政策

使用数据收集

本产品会自动收集使用情况和性能数据（例如产品名称和版本），以及浏览器信息（例如 IP 地址）（统称为“使用数据”）。Couchbase 会将使用数据与您可能提供给 Couchbase 的其他数据（例如用户名或电子邮件地址）结合使用，以开发和改进我们的产品，并为销售和营销计划提供信息。我们不会访问或收集您存储在 Couchbase 产品中的任何数据。我们使用使用数据来了解整体使用模式，并让产品更好地满足您的需求。有关 Couchbase 如何收集、保护和处理信息的更多信息，请参阅 https://www.couchbase.com/privacy-policy 上的 Couchbase 隐私政策。

大模型相关风险

• 使用大模型及类似技术存在风险，包括可能生成不准确或有害内容。
• Couchbase 不会审核或评估此类内容的质量或准确性，且这些内容可能不代表 Couchbase 的观点。
• 您需自行决定是否使用大模型及相关技术，并负责遵守适用于您使用这些技术的任何许可条款、使用条款和所在组织的政策。

支持政策

Couchbase MCP Server 为开源项目，由 Couchbase 工程师维护。您如何获得帮助取决于使用方式：

• 社区使用 — 请提交 GitHub issue报告错误、提出问题或申请功能。Couchbase 工程师会关注代码库，并尽力回复，但不承诺响应时间。Couchbase 支持门户无法为社区使用提供帮助。
• 企业支持 — 可通过购买许可 Couchbase AI Data Plane 获得，该许可还涵盖 Couchbase Agent Memory 和 Couchbase Agent Catalog。获得许可的客户可通过常用的 Couchbase 支持渠道寻求帮助。

感谢您使用并为本项目做出贡献！