MCP Server Couchbase

Name: MCP Server Couchbase
Author: couchbase

by couchbaseversion 1.1.0i★ –iRuns on your computer

Registry nameio.github.couchbase/mcp-server-couchbase

Install

Overview

Description from the maker (original English)

Couchbase MCP servers: Operational and Operational Insights clusters.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: CB_PASSWORD, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: 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

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into 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"
      }
    }
  }
}

Run this in your terminal

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

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.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"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

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 secret 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 secret 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 secret env
AWS access key ID, bedrock provider only. Omit to use the default AWS credential chain.
CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY secret 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.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account couchbase, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 32537 servers in this category
Published to the registry more recently than 88% of the other 32537 servers in this category
Basic checks equal to or better than 100% of the other 32537 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is MCP Server Couchbase safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: CB_PASSWORD, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.1.0) reached the registry 4 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv), Docker on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, TF Rooms

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

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

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

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

Runs in the cloud★ 211Updated yesterday

Install

TF Rooms

by tfrooms.com

Live room availability, rates and stay quotes for 12 New Leaf motels in Twin Falls, Idaho.

Runs in the cloudUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

Only the beginning is shown; read the rest in the repo

MCP Server Couchbase

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

TF Rooms

README from the maker

Couchbase MCP Server

Table of Contents

Why Couchbase MCP Server

Choosing a Server

Operational Server

Operational Quick Start

Operational Connection and Authentication