MCP Server Couchbase

Name: MCP Server Couchbase
Author: couchbase

作者：couchbase版本 1.1.0i★ –i在你的电脑上运行

注册名称io.github.couchbase/mcp-server-couchbase

安装

概览

作者提供的说明（英文原文）

Couchbase MCP servers: Operational and Operational Insights clusters.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 其他
你需要填写：CB_PASSWORD, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD, CB_CA_CERT_PATH, CB_CLIENT_CERT_PATH, CB_CLIENT_KEY_PATH, CB_MCP_READ_ONLY_MODE, CB_MCP_TRANSPORT, CB_MCP_HOST, CB_MCP_PORT, CB_MCP_WORKERS, CB_MCP_STATELESS_HTTP, CB_MCP_DISABLED_TOOLS, CB_MCP_CONFIRMATION_REQUIRED_TOOLS, CB_MCP_LOG_LEVEL, CB_MCP_LOG_SINKS, CB_MCP_LOG_FILE, CB_MCP_LOG_ROTATION_MAX_SIZE_MB, CB_MCP_LOG_MAX_BYTES, CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB, CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB, CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB, CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB, CB_MCP_LOG_RETENTION_BACKUP_COUNT, CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT, CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT, CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT, CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT, CB_MCP_OAUTH_JWT_JWKS_URI, CB_MCP_OAUTH_JWT_ISSUER, CB_MCP_OAUTH_JWT_AUDIENCE, CB_MCP_OAUTH_JWT_ALGORITHM, CB_MCP_OAUTH_MCP_BASE_URL, CB_MCP_OAUTH_SCOPE_READ_LABEL, CB_MCP_OAUTH_SCOPE_WRITE_LABEL, CB_MCP_AUDIT_LOG_ENABLED, CB_MCP_AUDIT_LOG_SINKS, CB_MCP_EMBEDDING_MODEL_PROVIDER, CB_MCP_AUDIT_LOG_FILE_PATH, CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB, CB_MCP_AUDIT_LOG_ROTATION_INTERVAL, CB_MCP_EMBEDDING_MODEL, CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS, CB_MCP_AUDIT_LOG_TOOL_ARGS, CB_MCP_AUDIT_LOG_DISABLED_EVENTS, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_ENDPOINT, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY, CB_MCP_EMBEDDING_MODEL_AWS_REGION

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

PyPI已安装 Python 的 uv（用于 uvx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server",
        "operational"
      ],
      "env": {
        "CB_CONNECTION_STRING": "your-value",
        "CB_USERNAME": "your-value",
        "CB_PASSWORD": "your-value",
        "CB_CA_CERT_PATH": "your-value",
        "CB_CLIENT_CERT_PATH": "your-value",
        "CB_CLIENT_KEY_PATH": "your-value",
        "CB_MCP_READ_ONLY_MODE": "your-value",
        "CB_MCP_TRANSPORT": "your-value",
        "CB_MCP_HOST": "your-value",
        "CB_MCP_PORT": "your-value",
        "CB_MCP_WORKERS": "your-value",
        "CB_MCP_STATELESS_HTTP": "your-value",
        "CB_MCP_DISABLED_TOOLS": "your-value",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
        "CB_MCP_LOG_LEVEL": "your-value",
        "CB_MCP_LOG_SINKS": "your-value",
        "CB_MCP_LOG_FILE": "your-value",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_MAX_BYTES": "your-value",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "your-value",
        "CB_MCP_OAUTH_JWT_ISSUER": "your-value",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "your-value",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "your-value",
        "CB_MCP_OAUTH_MCP_BASE_URL": "your-value",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "your-value",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "your-value",
        "CB_MCP_AUDIT_LOG_ENABLED": "your-value",
        "CB_MCP_AUDIT_LOG_SINKS": "your-value",
        "CB_MCP_EMBEDDING_MODEL_PROVIDER": "your-value",
        "CB_MCP_AUDIT_LOG_FILE_PATH": "your-value",
        "CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_AUDIT_LOG_ROTATION_INTERVAL": "your-value",
        "CB_MCP_EMBEDDING_MODEL": "your-value",
        "CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS": "your-value",
        "CB_MCP_AUDIT_LOG_TOOL_ARGS": "your-value",
        "CB_MCP_AUDIT_LOG_DISABLED_EVENTS": "your-value",
        "CB_MCP_EMBEDDING_MODEL_API_KEY": "your-value",
        "CB_MCP_EMBEDDING_MODEL_ENDPOINT": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_REGION": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add couchbase --env CB_CONNECTION_STRING=your-value --env CB_USERNAME=your-value --env CB_PASSWORD=your-value --env CB_CA_CERT_PATH=your-value --env CB_CLIENT_CERT_PATH=your-value --env CB_CLIENT_KEY_PATH=your-value --env CB_MCP_READ_ONLY_MODE=your-value --env CB_MCP_TRANSPORT=your-value --env CB_MCP_HOST=your-value --env CB_MCP_PORT=your-value --env CB_MCP_WORKERS=your-value --env CB_MCP_STATELESS_HTTP=your-value --env CB_MCP_DISABLED_TOOLS=your-value --env CB_MCP_CONFIRMATION_REQUIRED_TOOLS=your-value --env CB_MCP_LOG_LEVEL=your-value --env CB_MCP_LOG_SINKS=your-value --env CB_MCP_LOG_FILE=your-value --env CB_MCP_LOG_ROTATION_MAX_SIZE_MB=your-value --env CB_MCP_LOG_MAX_BYTES=your-value --env CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB=your-value --env CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB=your-value --env CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB=your-value --env CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB=your-value --env CB_MCP_LOG_RETENTION_BACKUP_COUNT=your-value --env CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT=your-value --env CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT=your-value --env CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT=your-value --env CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT=your-value --env CB_MCP_OAUTH_JWT_JWKS_URI=your-value --env CB_MCP_OAUTH_JWT_ISSUER=your-value --env CB_MCP_OAUTH_JWT_AUDIENCE=your-value --env CB_MCP_OAUTH_JWT_ALGORITHM=your-value --env CB_MCP_OAUTH_MCP_BASE_URL=your-value --env CB_MCP_OAUTH_SCOPE_READ_LABEL=your-value --env CB_MCP_OAUTH_SCOPE_WRITE_LABEL=your-value --env CB_MCP_AUDIT_LOG_ENABLED=your-value --env CB_MCP_AUDIT_LOG_SINKS=your-value --env CB_MCP_EMBEDDING_MODEL_PROVIDER=your-value --env CB_MCP_AUDIT_LOG_FILE_PATH=your-value --env CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB=your-value --env CB_MCP_AUDIT_LOG_ROTATION_INTERVAL=your-value --env CB_MCP_EMBEDDING_MODEL=your-value --env CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS=your-value --env CB_MCP_AUDIT_LOG_TOOL_ARGS=your-value --env CB_MCP_AUDIT_LOG_DISABLED_EVENTS=your-value --env CB_MCP_EMBEDDING_MODEL_API_KEY=your-value --env CB_MCP_EMBEDDING_MODEL_ENDPOINT=your-value --env CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID=your-value --env CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY=your-value --env CB_MCP_EMBEDDING_MODEL_AWS_REGION=your-value -- uvx couchbase-mcp-server operational

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server",
        "operational"
      ],
      "env": {
        "CB_CONNECTION_STRING": "your-value",
        "CB_USERNAME": "your-value",
        "CB_PASSWORD": "your-value",
        "CB_CA_CERT_PATH": "your-value",
        "CB_CLIENT_CERT_PATH": "your-value",
        "CB_CLIENT_KEY_PATH": "your-value",
        "CB_MCP_READ_ONLY_MODE": "your-value",
        "CB_MCP_TRANSPORT": "your-value",
        "CB_MCP_HOST": "your-value",
        "CB_MCP_PORT": "your-value",
        "CB_MCP_WORKERS": "your-value",
        "CB_MCP_STATELESS_HTTP": "your-value",
        "CB_MCP_DISABLED_TOOLS": "your-value",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
        "CB_MCP_LOG_LEVEL": "your-value",
        "CB_MCP_LOG_SINKS": "your-value",
        "CB_MCP_LOG_FILE": "your-value",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_MAX_BYTES": "your-value",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "your-value",
        "CB_MCP_OAUTH_JWT_ISSUER": "your-value",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "your-value",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "your-value",
        "CB_MCP_OAUTH_MCP_BASE_URL": "your-value",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "your-value",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "your-value",
        "CB_MCP_AUDIT_LOG_ENABLED": "your-value",
        "CB_MCP_AUDIT_LOG_SINKS": "your-value",
        "CB_MCP_EMBEDDING_MODEL_PROVIDER": "your-value",
        "CB_MCP_AUDIT_LOG_FILE_PATH": "your-value",
        "CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_AUDIT_LOG_ROTATION_INTERVAL": "your-value",
        "CB_MCP_EMBEDDING_MODEL": "your-value",
        "CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS": "your-value",
        "CB_MCP_AUDIT_LOG_TOOL_ARGS": "your-value",
        "CB_MCP_AUDIT_LOG_DISABLED_EVENTS": "your-value",
        "CB_MCP_EMBEDDING_MODEL_API_KEY": "your-value",
        "CB_MCP_EMBEDDING_MODEL_ENDPOINT": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_REGION": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "couchbase": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "couchbase-mcp-server",
        "operational"
      ],
      "env": {
        "CB_CONNECTION_STRING": "your-value",
        "CB_USERNAME": "your-value",
        "CB_PASSWORD": "your-value",
        "CB_CA_CERT_PATH": "your-value",
        "CB_CLIENT_CERT_PATH": "your-value",
        "CB_CLIENT_KEY_PATH": "your-value",
        "CB_MCP_READ_ONLY_MODE": "your-value",
        "CB_MCP_TRANSPORT": "your-value",
        "CB_MCP_HOST": "your-value",
        "CB_MCP_PORT": "your-value",
        "CB_MCP_WORKERS": "your-value",
        "CB_MCP_STATELESS_HTTP": "your-value",
        "CB_MCP_DISABLED_TOOLS": "your-value",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "your-value",
        "CB_MCP_LOG_LEVEL": "your-value",
        "CB_MCP_LOG_SINKS": "your-value",
        "CB_MCP_LOG_FILE": "your-value",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_MAX_BYTES": "your-value",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "your-value",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "your-value",
        "CB_MCP_OAUTH_JWT_ISSUER": "your-value",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "your-value",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "your-value",
        "CB_MCP_OAUTH_MCP_BASE_URL": "your-value",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "your-value",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "your-value",
        "CB_MCP_AUDIT_LOG_ENABLED": "your-value",
        "CB_MCP_AUDIT_LOG_SINKS": "your-value",
        "CB_MCP_EMBEDDING_MODEL_PROVIDER": "your-value",
        "CB_MCP_AUDIT_LOG_FILE_PATH": "your-value",
        "CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB": "your-value",
        "CB_MCP_AUDIT_LOG_ROTATION_INTERVAL": "your-value",
        "CB_MCP_EMBEDDING_MODEL": "your-value",
        "CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS": "your-value",
        "CB_MCP_AUDIT_LOG_TOOL_ARGS": "your-value",
        "CB_MCP_AUDIT_LOG_DISABLED_EVENTS": "your-value",
        "CB_MCP_EMBEDDING_MODEL_API_KEY": "your-value",
        "CB_MCP_EMBEDDING_MODEL_ENDPOINT": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY": "your-value",
        "CB_MCP_EMBEDDING_MODEL_AWS_REGION": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

CB_CONNECTION_STRING env
Couchbase connection string. Required for connecting to the cluster.
CB_USERNAME env
Couchbase database username. Required for basic authentication.
CB_PASSWORD 机密 env
Couchbase database password. Required for basic authentication.
CB_CA_CERT_PATH env
Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.
CB_CLIENT_CERT_PATH env
Couchbase client certificate path. Required for mTLS authentication.
CB_CLIENT_KEY_PATH env
Couchbase client key path. Required for mTLS authentication.
CB_MCP_READ_ONLY_MODE env
Couchbase read only mode. Set to true to disable write operations: KV document, scope/collection and index write tools are not loaded, and SQL++ queries that modify data are blocked. Set to false to…
CB_MCP_TRANSPORT env
Transport mode for the server (stdio, http or sse). Default is stdio. OAuth is only honored with http.
CB_MCP_HOST env
Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.
CB_MCP_PORT env
Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.
CB_MCP_WORKERS env
Number of server worker processes (default: 1). Values above 1 use more CPU cores, require the http transport, run in stateless HTTP mode, and cannot be combined with CB_MCP_CONFIRMATION_REQUIRED_TOO…
CB_MCP_STATELESS_HTTP env
Handle each HTTP request without per-session state (default: true when workers > 1, otherwise false). Only honored with the http transport; cannot be combined with CB_MCP_CONFIRMATION_REQUIRED_TOOLS.
CB_MCP_DISABLED_TOOLS env
Tools to disable. Accepts comma-separated tool names (e.g., 'tool_1,tool_2') or a file path containing one tool name per line.
CB_MCP_CONFIRMATION_REQUIRED_TOOLS env
Comma-separated tool names that require user confirmation before execution. Also accepts a file path containing one tool name per line. Requires the MCP client to support elicitation.
CB_MCP_LOG_LEVEL env
Logging level for the MCP server. One of off, debug, info, warning, error. Use 'off' to disable logging entirely. Invalid values fall back to info. Default is info.
CB_MCP_LOG_SINKS env
Comma-separated list of log destinations. Allowed values: stderr, file. Include 'file' to write per-level log files; include 'stderr' to write to the console. Default is stderr.
CB_MCP_LOG_FILE env
Base path for the per-level log files. One rotating file is written per level (e.g. mcp_server.info.log, mcp_server.error.log). Only used when 'file' is in CB_MCP_LOG_SINKS. Default is mcp_server.log.
CB_MCP_LOG_ROTATION_MAX_SIZE_MB env
Global maximum size in MB per-level log file before it rotates, inherited by every level unless overridden by a per-level CB_MCP_LOG_ _ROTATION_MAX_SIZE_MB. A value of 0 is invalid and falls back to…
CB_MCP_LOG_MAX_BYTES env
[DEPRECATED] Global rotation size in bytes; use CB_MCP_LOG_ROTATION_MAX_SIZE_MB (MB) instead. Still honored for backward compatibility but ignored when CB_MCP_LOG_ROTATION_MAX_SIZE_MB is also set. A…
CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB env
Rotation size in MB for the ERROR log file. Overrides CB_MCP_LOG_ROTATION_MAX_SIZE_MB for ERROR; inherits it when unset. 0 is invalid and falls back to the inherited global with a startup warning.
CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB env
Rotation size in MB for the WARNING log file. Overrides CB_MCP_LOG_ROTATION_MAX_SIZE_MB for WARNING; inherits it when unset. 0 is invalid and falls back to the inherited global with a startup warning.
CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB env
Rotation size in MB for the INFO log file. Overrides CB_MCP_LOG_ROTATION_MAX_SIZE_MB for INFO; inherits it when unset. 0 is invalid and falls back to the inherited global with a startup warning.
CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB env
Rotation size in MB for the DEBUG log file. Overrides CB_MCP_LOG_ROTATION_MAX_SIZE_MB for DEBUG; inherits it when unset. 0 is invalid and falls back to the inherited global with a startup warning.
CB_MCP_LOG_RETENTION_BACKUP_COUNT env
Number of rotated backup files kept per-level log file, excluding the live file. Applies to every level unless overridden per level. Set to 0 to keep only the live file (still capped by the rotation…
CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT env
Rotated backups kept for the ERROR log file. Overrides CB_MCP_LOG_RETENTION_BACKUP_COUNT for ERROR; inherits it when unset.
CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT env
Rotated backups kept for the WARNING log file. Overrides CB_MCP_LOG_RETENTION_BACKUP_COUNT for WARNING; inherits it when unset.
CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT env
Rotated backups kept for the INFO log file. Overrides CB_MCP_LOG_RETENTION_BACKUP_COUNT for INFO; inherits it when unset.
CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT env
Rotated backups kept for the DEBUG log file. Overrides CB_MCP_LOG_RETENTION_BACKUP_COUNT for DEBUG; inherits it when unset.
CB_MCP_OAUTH_JWT_JWKS_URI env
JWKS endpoint of the identity provider used to verify bearer JWT signatures. Required to enable OAuth, along with CB_MCP_OAUTH_JWT_ISSUER and CB_MCP_OAUTH_JWT_AUDIENCE. Only honored when CB_MCP_TRANS…
CB_MCP_OAUTH_JWT_ISSUER env
Expected JWT 'iss' claim value. Also advertised as the authorization server in Protected Resource Metadata when CB_MCP_OAUTH_MCP_BASE_URL is set. Required to enable OAuth.
CB_MCP_OAUTH_JWT_AUDIENCE env
Expected JWT 'aud' claim value. Required to enable OAuth.
CB_MCP_OAUTH_JWT_ALGORITHM env
JWT signing algorithm. One of RS256/384/512, ES256/384/512, PS256/384/512. Default is RS256.
CB_MCP_OAUTH_MCP_BASE_URL env
Public base URL of this MCP server. When set, the server publishes RFC 9728 Protected Resource Metadata at /.well-known/oauth-protected-resource/mcp so PRM-aware clients can discover the authorizatio…
CB_MCP_OAUTH_SCOPE_READ_LABEL env
Override the OAuth scope label the server treats as 'read' access; advertised in PRM and matched against the token's scope/scp claim. Use when your IdP cannot emit the canonical form. Default is couc…
CB_MCP_OAUTH_SCOPE_WRITE_LABEL env
Override the OAuth scope label the server treats as 'write' access; same semantics as CB_MCP_OAUTH_SCOPE_READ_LABEL. Default is couchbase-mcp:write.
CB_MCP_AUDIT_LOG_ENABLED env
Enable audit logging. Audit output is a separate sink from the CB_MCP_LOG_* operational logs, with a stable schema, its own retention, and events that cannot be filtered out. Default is false.
CB_MCP_AUDIT_LOG_SINKS env
Comma-separated audit destinations: console, file, or both. 'console' writes to stderr, never stdout, because stdout carries the JSON-RPC protocol under the stdio transport. Default is console.
CB_MCP_EMBEDDING_MODEL_PROVIDER env
Embedding provider for run_vector_query / run_vector_search: one of capella, openai, cohere, voyage, bedrock. Unset disables both tools' embedding step until configured.
CB_MCP_AUDIT_LOG_FILE_PATH env
Path to the audit log file, required when 'file' is in CB_MCP_AUDIT_LOG_SINKS. Each server process writes its own file with the host and process id inserted before the extension (audit.log becomes au…
CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB env
Maximum size in MB the live audit file may reach before it rotates. 0 turns size-based rotation off. Default is 10 MB.
CB_MCP_AUDIT_LOG_ROTATION_INTERVAL env
Age the live audit file may reach before it rotates, as where the unit is 'd' (24 hours) or 'w' (7 days) - for example 1d, 30d, 1w, 8w. 0 turns interval-based rotation off. Size and interval are inde…
CB_MCP_EMBEDDING_MODEL env
Model name/ID for the configured embedding provider.
CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS env
Number of rotated audit files retained, excluding the live file. Rotated files are gzipped and named with the UTC rotation time. Set to 0 to keep no backups: the live file is truncated at each rotati…
CB_MCP_AUDIT_LOG_TOOL_ARGS env
Record tool argument values in the audit log. Off by default: there is no redaction in this release, so enabling this writes arguments verbatim, including the full document bodies passed to document-…
CB_MCP_AUDIT_LOG_DISABLED_EVENTS env
Audit events to suppress, as comma-separated numeric event ids (for example '61490,61492'), or a path to a file with one id per line. Ids are listed in the audit descriptor shipped with the package.…
CB_MCP_EMBEDDING_MODEL_API_KEY 机密 env
API key for the configured embedding provider. Not used by bedrock (uses the AWS credential chain / CB_MCP_EMBEDDING_MODEL_AWS_* instead).
CB_MCP_EMBEDDING_MODEL_ENDPOINT env
Base URL override for the configured embedding provider (e.g. an OpenAI-compatible local server, or a Capella Model Service deployment's own URL). Required when CB_MCP_EMBEDDING_MODEL_PROVIDER=capell…
CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID 机密 env
AWS access key ID, bedrock provider only. Omit to use the default AWS credential chain.
CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY 机密 env
AWS secret access key, bedrock provider only.
CB_MCP_EMBEDDING_MODEL_AWS_REGION env
AWS region, bedrock provider only. Falls back to the AWS SDK's own region resolution if unset.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月6日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 couchbase 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“其他”中的其他服务器比较i

星标数多于此分类中其他 32497 个服务器的 0%
发布到注册中心的时间比此分类中其他 32497 个服务器的 88% 更新
基础检查结果等于或优于此分类中其他 32497 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

MCP Server Couchbase 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：CB_PASSWORD, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（1.1.0）于4天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv), Docker。

有什么可以替代它？

同一分类中有：Spec Driven Development, Remote Desktop Commander, Zoo MCP

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

在你的电脑上运行★ 440MIT14个月前更新

安装

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

在云端运行★ 211昨天更新

安装

Zoo MCP

作者：KittyCAD

An MCP server that provides access to the Zoo API for various CAD operations and tools.

在你的电脑上运行今天更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Couchbase MCP Server

Couchbase MCP Server is a self-hosted MCP Server that allows AI agents to connect to and interact with data in Couchbase Servers (whether hosted on Capella or self-managed) or Operational Insights Enterprise. It provides tools across categories including Cluster Health, Data Schema, Query, and more — with safety controls via read-only mode and fine-grained tool disabling. It supports both STDIO and Streamable HTTP transports with OAuth capabilities.

Couchbase MCP Server is distributed as a Python Package Index (PyPI) package and via Docker. Enterprise support for Couchbase MCP Server is available by licensing Couchbase AI Data Plane, which also entitles use and enterprise support of Couchbase Agent Memory and Couchbase Agent Catalog.

[][cursor-install-basic]

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

Why Couchbase MCP Server
Choosing a Server
Operational Server
Quick Start
Connection and Authentication
Tools
Embedding Providers
All Options
Operational Insights Server
Quick Start
Connection and Authentication
Tools
Exporting Large Results
Common Configuration
Safety Controls
Transports
OAuth 2.1 Authorization
Logging
Auditing
Client Setup
Docker
Troubleshooting
FAQ
Contributing
Usage Data, LLM Risks and Support Policy

Why Couchbase MCP Server

Safe by default — write tools are not loaded and data-modifying queries are blocked unless you set CB_MCP_READ_ONLY_MODE=false; individual tools can also be disabled or gated behind user confirmation.
Couchbase Server and Operational Insights — the operational server connects to Couchbase Capella or a self-managed Couchbase Server cluster with the same configuration; the Operational Insights server connects to self-managed Operational Insights clusters.
RBAC-aware — tool controls guide the LLM; the Couchbase user's role-based access control remains the authoritative security boundary.
Production transports — STDIO for local desktop clients, or Streamable HTTP with optional OAuth 2.1 (any JWKS-publishing IdP: Auth0, Okta, Keycloak, Entra, Cognito, …), health checks and audit logging for shared deployments. The operational server can also run multiple workers to use more CPU cores.
Any MCP client — tested with Claude Desktop, Cursor, Windsurf, VS Code and JetBrains AI Assistant/Junie.

Once connected, you can ask things like:

"What buckets, scopes and collections do I have, and what's the schema of the orders collection?"
"Find the 10 most recent documents in users where status = 'active'."
"What are the 5 slowest queries in the last hour, and are any of them missing a covering index?"
"Is this cluster healthy, and which services are running?"
"Insert a new document into products with these fields: …" (requires CB_MCP_READ_ONLY_MODE=false)

Choosing a Server

This package ships two MCP servers. Each one is started by its own subcommand, connects to a different kind of cluster, and has its own tools. Pick the one that matches your cluster, follow its section for setup and tools, then use Common Configuration for the settings both share. To use both, register each as a separate server in your MCP client.

	Operational server	Operational Insights server
Use it with	A Couchbase cluster (Capella or self-managed)	A self-managed Operational Insights cluster (not available on Capella)
Subcommand	`operational` (the default)	`operational-insights`
Connection string	`couchbase://` / `couchbases://`	HTTP(S) URL, e.g. `http://localhost:8095`
Credential variables	`CB_CONNECTION_STRING`, `CB_USERNAME`, …	`CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING`, `CB_OPERATIONAL_INSIGHTS_USERNAME`, …
Tools	52 — cluster health, schema, KV, SQL++, indexes, full-text and vector search, query performance	13 — schema, SQL++ (sync and async), indexes, exports
Default HTTP port	`8000`	`8001`
Default log file	`mcp_server.log`	`mcp_server_operational_insights.log`

The subcommand is optional for the operational server today — a bare couchbase-mcp-server starts it — but naming it keeps your configuration unambiguous. Options go after the subcommand: couchbase-mcp-server operational --transport=http. Check the installed version with uvx couchbase-mcp-server --version.

Operational Server

The operational server connects to a Couchbase cluster on Capella or self-managed Couchbase Server, using the couchbase Python SDK.

Operational Quick Start

You need a running Couchbase cluster — the Capella free tier is the quickest way to get one (you can import a sample dataset) — and an MCP client. Add one of these configurations to your client (see Client Setup for where each client keeps it). If the client already has other servers, add couchbase to the existing mcpServers object.

From PyPI with uvx (requires uv and 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" } } } }

With Docker (requires only 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" ] } } }

From source

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/ is the path to your clone — keep the trailing slash. After pulling updates, run uv sync to update dependencies.

Operational Connection and Authentication

Use either a username and password or a client certificate (mTLS). If both are set, the certificate is used.

Environment Variable	CLI Argument	Description
`CB_CONNECTION_STRING`	`--connection-string`	Connection string to the cluster. Required
`CB_USERNAME` / `CB_PASSWORD`	`--username` / `--password`	Basic authentication
`CB_CLIENT_CERT_PATH` / `CB_CLIENT_KEY_PATH`	`--client-cert-path` / `--client-key-path`	mTLS authentication
`CB_CA_CERT_PATH`	`--ca-cert-path`	Root certificate for a self-signed/untrusted server certificate (not needed for Capella)

mTLS example

"mcpServers": { "couchbase": { "command": "uvx",

只显示了开头部分；其余内容请在仓库中阅读