Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Las reseñas y las cuentas llegarán en una etapa posterior.
PopNx MCPServidores MCP para quienes usan IA · explicados con palabras sencillas

MCP Server Couchbase

de couchbaseversión 1.1.0i★ –iSe ejecuta en tu computadora
Nombre en el registroio.github.couchbase/mcp-server-couchbase

Instalar

Resumen

Descripción del creador (original en inglés)

Couchbase MCP servers: Operational and Operational Insights clusters.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

  • Conexión: Se ejecuta en tu computadora
  • Transporte: stdio
  • Categoría: Otros
  • Debes completar: CB_PASSWORD, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

  • Revisiones básicas: 1 de 1 superadas
  • Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
  • Debes completar tú: 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

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

  • PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en 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"
      }
    }
  }
}

Ejecuta esto en tu 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

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.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"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

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

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 6 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub couchbase, dueña del repo

  • … Aún sin revisar

    Sigue en mantenimiento

    Todavía no hemos leído este repo en GitHub

  • … Aún sin revisar

    Tiene licencia

    Todavía no hemos leído este repo en GitHub

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

  • Más estrellas que el 0% de los otros 32466 servidores de esta categoría
  • Publicado en el registro más recientemente que el 89% de los otros 32466 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 32466 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro MCP Server Couchbase?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: CB_PASSWORD, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (1.1.0) llegó al registro hace 4 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv), Docker en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, HotCodePush

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

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

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses
Instalar

Remote Desktop Commander

de desktop-commander

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

Se ejecuta en la nube★ 211Actualizado ayer
Instalar

HotCodePush

de hotcodepush-team

Manage over-the-air (OTA) updates for React Native, Expo, Capacitor and Cordova apps.

Se ejecuta en la nubeActualizado hoy
Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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

Table of Contents

  • 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 serverOperational Insights server
Use it withA Couchbase cluster (Capella or self-managed)A self-managed Operational Insights cluster (not available on Capella)
Subcommandoperational (the default)operational-insights
Connection stringcouchbase:// / couchbases://HTTP(S) URL, e.g. http://localhost:8095
Credential variablesCB_CONNECTION_STRING, CB_USERNAME, …CB_OPERATIONAL_INSIGHTS_CONNECTION_STRING, CB_OPERATIONAL_INSIGHTS_USERNAME, …
Tools52 — cluster health, schema, KV, SQL++, indexes, full-text and vector search, query performance13 — schema, SQL++ (sync and async), indexes, exports
Default HTTP port80008001
Default log filemcp_server.logmcp_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 VariableCLI ArgumentDescription
CB_CONNECTION_STRING--connection-stringConnection string to the cluster. Required
CB_USERNAME / CB_PASSWORD--username / --passwordBasic authentication
CB_CLIENT_CERT_PATH / CB_CLIENT_KEY_PATH--client-cert-path / --client-key-pathmTLS authentication
CB_CA_CERT_PATH--ca-cert-pathRoot certificate for a self-signed/untrusted server certificate (not needed for Capella)

mTLS example

{

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

Solo se muestra el principio; lee el resto en el repo

Pregunta a PopNx