Skip to content
VS Code

mcp server couchbase for VS Code

io.github.couchbase/mcp-server-couchbase

Couchbase MCP Server - Enable AI agents to connect to and interact with Couchbase clusters.

client:VS Code transport:stdio runtime:pypi

Install mcp server couchbase in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "cb-connection-string",
      "description": "CB_CONNECTION_STRING",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-username",
      "description": "CB_USERNAME",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-password",
      "description": "CB_PASSWORD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-ca-cert-path",
      "description": "CB_CA_CERT_PATH",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-client-cert-path",
      "description": "CB_CLIENT_CERT_PATH",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-client-key-path",
      "description": "CB_CLIENT_KEY_PATH",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-read-only-mode",
      "description": "CB_MCP_READ_ONLY_MODE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-transport",
      "description": "CB_MCP_TRANSPORT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-host",
      "description": "CB_MCP_HOST",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-port",
      "description": "CB_MCP_PORT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-disabled-tools",
      "description": "CB_MCP_DISABLED_TOOLS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-confirmation-required-tools",
      "description": "CB_MCP_CONFIRMATION_REQUIRED_TOOLS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-level",
      "description": "CB_MCP_LOG_LEVEL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-sinks",
      "description": "CB_MCP_LOG_SINKS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-file",
      "description": "CB_MCP_LOG_FILE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-rotation-max-size-mb",
      "description": "CB_MCP_LOG_ROTATION_MAX_SIZE_MB",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-max-bytes",
      "description": "CB_MCP_LOG_MAX_BYTES",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-error-rotation-max-size-mb",
      "description": "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-warning-rotation-max-size-mb",
      "description": "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-info-rotation-max-size-mb",
      "description": "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-debug-rotation-max-size-mb",
      "description": "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-retention-backup-count",
      "description": "CB_MCP_LOG_RETENTION_BACKUP_COUNT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-error-retention-backup-count",
      "description": "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-warning-retention-backup-count",
      "description": "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-info-retention-backup-count",
      "description": "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-log-debug-retention-backup-count",
      "description": "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-oauth-jwt-jwks-uri",
      "description": "CB_MCP_OAUTH_JWT_JWKS_URI",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-oauth-jwt-issuer",
      "description": "CB_MCP_OAUTH_JWT_ISSUER",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-oauth-jwt-audience",
      "description": "CB_MCP_OAUTH_JWT_AUDIENCE",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-oauth-jwt-algorithm",
      "description": "CB_MCP_OAUTH_JWT_ALGORITHM",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-oauth-mcp-base-url",
      "description": "CB_MCP_OAUTH_MCP_BASE_URL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-oauth-scope-read-label",
      "description": "CB_MCP_OAUTH_SCOPE_READ_LABEL",
      "password": true
    },
    {
      "type": "promptString",
      "id": "cb-mcp-oauth-scope-write-label",
      "description": "CB_MCP_OAUTH_SCOPE_WRITE_LABEL",
      "password": true
    }
  ],
  "servers": {
    "mcp-server-couchbase": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "${input:cb-connection-string}",
        "CB_USERNAME": "${input:cb-username}",
        "CB_PASSWORD": "${input:cb-password}",
        "CB_CA_CERT_PATH": "${input:cb-ca-cert-path}",
        "CB_CLIENT_CERT_PATH": "${input:cb-client-cert-path}",
        "CB_CLIENT_KEY_PATH": "${input:cb-client-key-path}",
        "CB_MCP_READ_ONLY_MODE": "${input:cb-mcp-read-only-mode}",
        "CB_MCP_TRANSPORT": "${input:cb-mcp-transport}",
        "CB_MCP_HOST": "${input:cb-mcp-host}",
        "CB_MCP_PORT": "${input:cb-mcp-port}",
        "CB_MCP_DISABLED_TOOLS": "${input:cb-mcp-disabled-tools}",
        "CB_MCP_CONFIRMATION_REQUIRED_TOOLS": "${input:cb-mcp-confirmation-required-tools}",
        "CB_MCP_LOG_LEVEL": "${input:cb-mcp-log-level}",
        "CB_MCP_LOG_SINKS": "${input:cb-mcp-log-sinks}",
        "CB_MCP_LOG_FILE": "${input:cb-mcp-log-file}",
        "CB_MCP_LOG_ROTATION_MAX_SIZE_MB": "${input:cb-mcp-log-rotation-max-size-mb}",
        "CB_MCP_LOG_MAX_BYTES": "${input:cb-mcp-log-max-bytes}",
        "CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB": "${input:cb-mcp-log-error-rotation-max-size-mb}",
        "CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB": "${input:cb-mcp-log-warning-rotation-max-size-mb}",
        "CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB": "${input:cb-mcp-log-info-rotation-max-size-mb}",
        "CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB": "${input:cb-mcp-log-debug-rotation-max-size-mb}",
        "CB_MCP_LOG_RETENTION_BACKUP_COUNT": "${input:cb-mcp-log-retention-backup-count}",
        "CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT": "${input:cb-mcp-log-error-retention-backup-count}",
        "CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT": "${input:cb-mcp-log-warning-retention-backup-count}",
        "CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT": "${input:cb-mcp-log-info-retention-backup-count}",
        "CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT": "${input:cb-mcp-log-debug-retention-backup-count}",
        "CB_MCP_OAUTH_JWT_JWKS_URI": "${input:cb-mcp-oauth-jwt-jwks-uri}",
        "CB_MCP_OAUTH_JWT_ISSUER": "${input:cb-mcp-oauth-jwt-issuer}",
        "CB_MCP_OAUTH_JWT_AUDIENCE": "${input:cb-mcp-oauth-jwt-audience}",
        "CB_MCP_OAUTH_JWT_ALGORITHM": "${input:cb-mcp-oauth-jwt-algorithm}",
        "CB_MCP_OAUTH_MCP_BASE_URL": "${input:cb-mcp-oauth-mcp-base-url}",
        "CB_MCP_OAUTH_SCOPE_READ_LABEL": "${input:cb-mcp-oauth-scope-read-label}",
        "CB_MCP_OAUTH_SCOPE_WRITE_LABEL": "${input:cb-mcp-oauth-scope-write-label}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

mcp server couchbase in other clients