Connect Runs on your machine

Terminal

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

claude_desktop_config.json

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

~/.cursor/mcp.json

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

.vscode/mcp.json

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

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools

This server runs locally, so its tools are listed by your MCP client once it starts.

Environment variables

Name	Description
`CB_CONNECTION_STRING` Optional	Couchbase connection string. Required for connecting to the cluster.
`CB_USERNAME` Optional	Couchbase database username. Required for basic authentication.
`CB_PASSWORD` Optional, secret	Couchbase database password. Required for basic authentication.
`CB_CA_CERT_PATH` Optional	Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.
`CB_CLIENT_CERT_PATH` Optional	Couchbase client certificate path. Required for mTLS authentication.
`CB_CLIENT_KEY_PATH` Optional	Couchbase client key path. Required for mTLS authentication.
`CB_MCP_READ_ONLY_MODE` Optional	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 allow them. Default is true.
`CB_MCP_TRANSPORT` Optional	Transport mode for the server (stdio, http or sse). Default is stdio. OAuth is only honored with http.
`CB_MCP_HOST` Optional	Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.
`CB_MCP_PORT` Optional	Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.
`CB_MCP_WORKERS` Optional	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_TOOLS. Each worker writes log files named with the host and process id.
`CB_MCP_STATELESS_HTTP` Optional	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` Optional	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` Optional	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` Optional	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` Optional	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` Optional	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` Optional	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_<LEVEL>_ROTATION_MAX_SIZE_MB. A value of 0 is invalid and falls back to the default (1 MB) with a startup warning. Default is 1 (1 MB).
`CB_MCP_LOG_MAX_BYTES` Optional	[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 value of 0 is invalid and falls back to the default with a startup warning.
`CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB` Optional	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` Optional	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` Optional	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` Optional	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` Optional	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 size). Default is 1.
`CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT` Optional	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` Optional	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` Optional	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` Optional	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` Optional	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_TRANSPORT=http.
`CB_MCP_OAUTH_JWT_ISSUER` Optional	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` Optional	Expected JWT 'aud' claim value. Required to enable OAuth.
`CB_MCP_OAUTH_JWT_ALGORITHM` Optional	JWT signing algorithm. One of RS256/384/512, ES256/384/512, PS256/384/512. Default is RS256.
`CB_MCP_OAUTH_MCP_BASE_URL` Optional	Public base URL of this MCP server. When set, the server publishes RFC 9728 Protected Resource Metadata at <base_url>/.well-known/oauth-protected-resource/mcp so PRM-aware clients can discover the authorization server. Optional.
`CB_MCP_OAUTH_SCOPE_READ_LABEL` Optional	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 couchbase-mcp:read.
`CB_MCP_OAUTH_SCOPE_WRITE_LABEL` Optional	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` Optional	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` Optional	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` Optional	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` Optional	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 audit.myhost.1234.log), because a stdio deployment runs one process per client. If the path is missing…
`CB_MCP_AUDIT_LOG_ROTATION_MAX_SIZE_MB` Optional	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` Optional	Age the live audit file may reach before it rotates, as <value><unit> 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 independent: whichever falls due first rotates the file. Default is 1d.
`CB_MCP_EMBEDDING_MODEL` Optional	Model name/ID for the configured embedding provider.
`CB_MCP_AUDIT_LOG_RETENTION_MAX_BACKUPS` Optional	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 rotation. Default is 10.
`CB_MCP_AUDIT_LOG_TOOL_ARGS` Optional	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-write tools. Review the audit file's retention and access controls before enabling it.
`CB_MCP_AUDIT_LOG_DISABLED_EVENTS` Optional	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. Only filterable events can be suppressed: write and security events are always recorded, and an atte…
`CB_MCP_EMBEDDING_MODEL_API_KEY` Optional, secret	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` Optional	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=capella.
`CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID` Optional, secret	AWS access key ID, bedrock provider only. Omit to use the default AWS credential chain.
`CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY` Optional, secret	AWS secret access key, bedrock provider only.
`CB_MCP_EMBEDDING_MODEL_AWS_REGION` Optional	AWS region, bedrock provider only. Falls back to the AWS SDK's own region resolution if unset.

Details

Package	`[email protected]` (PYPI, stdio)
Package	`[email protected]` (PYPI, stdio)
Package	`docker.io/couchbase/mcp-server:1.1.0` (OCI, stdio)
Package	`docker.io/couchbase/mcp-server:1.1.0` (OCI, stdio)
First published	2 Nov 2026
Last updated	2 Nov 2026
Registry name	`io.github.couchbase/mcp-server-couchbase`

Mcp Server Couchbase

Connect Runs on your machine

Tools

Environment variables

Details

More data and analytics servers See all