x=hub

your toolset

    build deployment
    sign in

    mcp-server-couchbase

    mcpkey · package
    io.github.couchbase/mcp-server-couchbase · v1.0.1
    deploy just this

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

    run it

    on your own machines, one way per deploy method
    generated from the record, not tested yet
    #!/usr/bin/env bash
# couchbase (io.github.couchbase/mcp-server-couchbase), recipe baremetal (generated).
# Generated by Hub for toolset "my-agent"; started by mcp-my-agent-couchbase.service.
set -euo pipefail
export HOST=127.0.0.1 PORT=8101
exec uvx mcp-proxy --host 127.0.0.1 --port 8101 --pass-environment -- uvx couchbase-mcp-server==1.0.1

[Unit]
Description=MCP server couchbase (toolset my-agent), generated by Hub
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=mcp
Group=mcp
EnvironmentFile=/etc/mcp/my-agent.env
Environment=HOME=/var/lib/mcp/couchbase
WorkingDirectory=/var/lib/mcp/couchbase
ExecStart=/opt/mcp/my-agent/bin/couchbase.sh
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/lib/mcp/couchbase

[Install]
WantedBy=multi-user.target
    generated from the record, not tested yet
    docker run --rm -p 127.0.0.1:8101:8000 -e CB_CONNECTION_STRING -e CB_USERNAME -e CB_PASSWORD -e CB_CA_CERT_PATH -e CB_CLIENT_CERT_PATH -e CB_CLIENT_KEY_PATH -e CB_MCP_READ_ONLY_MODE -e CB_MCP_TRANSPORT -e CB_MCP_HOST -e CB_MCP_PORT -e CB_MCP_DISABLED_TOOLS -e CB_MCP_CONFIRMATION_REQUIRED_TOOLS -e CB_MCP_LOG_LEVEL -e CB_MCP_LOG_SINKS -e CB_MCP_LOG_FILE -e CB_MCP_LOG_ROTATION_MAX_SIZE_MB -e CB_MCP_LOG_MAX_BYTES -e CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB -e CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB -e CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB -e CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB -e CB_MCP_LOG_RETENTION_BACKUP_COUNT -e CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT -e CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT -e CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT -e CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT -e CB_MCP_OAUTH_JWT_JWKS_URI -e CB_MCP_OAUTH_JWT_ISSUER -e CB_MCP_OAUTH_JWT_AUDIENCE -e CB_MCP_OAUTH_JWT_ALGORITHM -e CB_MCP_OAUTH_MCP_BASE_URL -e CB_MCP_OAUTH_SCOPE_READ_LABEL -e CB_MCP_OAUTH_SCOPE_WRITE_LABEL ghcr.io/astral-sh/uv:python3.12-bookworm-slim sh -c 'uvx mcp-proxy --host 0.0.0.0 --port 8000 --pass-environment -- uvx couchbase-mcp-server==1.0.1'
    generated from the record, not tested yet
    # Generated by Hub for toolset "my-agent" (2026-10-18T03:11:51+00:00).
# Each package server runs behind a stdio->HTTP bridge and listens on localhost only.
#   cp .env.example .env    # fill the ${VAR}s
#   docker compose up -d && bash smoke.sh
# Remote servers are not here: clients reach them directly (see clients/).
name: mcp-my-agent
services:
  couchbase:
    image: ghcr.io/astral-sh/uv:python3.12-bookworm-slim
    command:
    - sh
    - -c
    - uvx mcp-proxy --host 0.0.0.0 --port 8000 --pass-environment -- uvx couchbase-mcp-server==1.0.1
    ports:
    - 127.0.0.1:8101:8000
    volumes:
    - uv-cache:/root/.cache/uv
    healthcheck:
      test:
      - CMD
      - python3
      - -c
      - import urllib.request; urllib.request.urlopen('http://127.0.0.1:8000/status')
      interval: 30s
      timeout: 5s
      retries: 5
      start_period: 2m
    restart: unless-stopped
    environment:
      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_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}
volumes:
  npm-cache: {}
  uv-cache: {}
    generated from the record, not tested yet
    # Generated by Hub for toolset "my-agent" (2026-10-18T03:11:51+00:00).
#   kubectl create namespace mcp
#   kubectl -n mcp create secret generic mcp-credentials --from-env-file=.env
#   kubectl apply -f kubernetes.yaml
# Services are cluster-internal: <name>.mcp.svc.cluster.local:8000/mcp. Put an ingress
# with auth in front before exposing any of them.
apiVersion: v1
kind: Namespace
metadata:
  name: mcp
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: couchbase
  namespace: mcp
  labels: &id001
    app: couchbase
spec:
  replicas: 1
  selector:
    matchLabels: *id001
  template:
    metadata:
      labels: *id001
    spec:
      containers:
      - name: couchbase
        image: ghcr.io/astral-sh/uv:python3.12-bookworm-slim
        ports:
        - containerPort: 8000
          name: http
        env:
        - name: CB_CONNECTION_STRING
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_CONNECTION_STRING
        - name: CB_USERNAME
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_USERNAME
        - name: CB_PASSWORD
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_PASSWORD
        - name: CB_CA_CERT_PATH
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_CA_CERT_PATH
        - name: CB_CLIENT_CERT_PATH
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_CLIENT_CERT_PATH
        - name: CB_CLIENT_KEY_PATH
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_CLIENT_KEY_PATH
        - name: CB_MCP_READ_ONLY_MODE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_READ_ONLY_MODE
        - name: CB_MCP_TRANSPORT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_TRANSPORT
        - name: CB_MCP_HOST
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_HOST
        - name: CB_MCP_PORT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_PORT
        - name: CB_MCP_DISABLED_TOOLS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_DISABLED_TOOLS
        - name: CB_MCP_CONFIRMATION_REQUIRED_TOOLS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_CONFIRMATION_REQUIRED_TOOLS
        - name: CB_MCP_LOG_LEVEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_LEVEL
        - name: CB_MCP_LOG_SINKS
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_SINKS
        - name: CB_MCP_LOG_FILE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_FILE
        - name: CB_MCP_LOG_ROTATION_MAX_SIZE_MB
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_ROTATION_MAX_SIZE_MB
        - name: CB_MCP_LOG_MAX_BYTES
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_MAX_BYTES
        - name: CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB
        - name: CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB
        - name: CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB
        - name: CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB
        - name: CB_MCP_LOG_RETENTION_BACKUP_COUNT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_RETENTION_BACKUP_COUNT
        - name: CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT
        - name: CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT
        - name: CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT
        - name: CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT
        - name: CB_MCP_OAUTH_JWT_JWKS_URI
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_OAUTH_JWT_JWKS_URI
        - name: CB_MCP_OAUTH_JWT_ISSUER
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_OAUTH_JWT_ISSUER
        - name: CB_MCP_OAUTH_JWT_AUDIENCE
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_OAUTH_JWT_AUDIENCE
        - name: CB_MCP_OAUTH_JWT_ALGORITHM
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_OAUTH_JWT_ALGORITHM
        - name: CB_MCP_OAUTH_MCP_BASE_URL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_OAUTH_MCP_BASE_URL
        - name: CB_MCP_OAUTH_SCOPE_READ_LABEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_OAUTH_SCOPE_READ_LABEL
        - name: CB_MCP_OAUTH_SCOPE_WRITE_LABEL
          valueFrom:
            secretKeyRef:
              name: mcp-credentials
              key: CB_MCP_OAUTH_SCOPE_WRITE_LABEL
        command:
        - sh
        - -c
        - uvx mcp-proxy --host 0.0.0.0 --port 8000 --pass-environment -- uvx couchbase-mcp-server==1.0.1
        readinessProbe:
          httpGet:
            path: /status
            port: http
          initialDelaySeconds: 10
---
apiVersion: v1
kind: Service
metadata:
  name: couchbase
  namespace: mcp
spec:
  selector:
    app: couchbase
  ports:
  - port: 8000
    targetPort: http
    name: http
    generated from the record, not tested yet
    # Generated by Hub for toolset "my-agent" (2026-10-18T03:11:51+00:00).
# Credentials come from the Secret 'mcp-credentials' (kubectl create secret generic ... --from-env-file=.env).
# Each server under `servers` is one Deployment + Service; the keys after it configure
# upstream charts a worker verified.
servers:
  couchbase:
    enabled: true
    replicas: 1
    port: 8000
    path: /mcp
    container:
      name: couchbase
      image: ghcr.io/astral-sh/uv:python3.12-bookworm-slim
      ports:
      - containerPort: 8000
        name: http
      env:
      - name: CB_CONNECTION_STRING
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_CONNECTION_STRING
      - name: CB_USERNAME
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_USERNAME
      - name: CB_PASSWORD
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_PASSWORD
      - name: CB_CA_CERT_PATH
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_CA_CERT_PATH
      - name: CB_CLIENT_CERT_PATH
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_CLIENT_CERT_PATH
      - name: CB_CLIENT_KEY_PATH
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_CLIENT_KEY_PATH
      - name: CB_MCP_READ_ONLY_MODE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_READ_ONLY_MODE
      - name: CB_MCP_TRANSPORT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_TRANSPORT
      - name: CB_MCP_HOST
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_HOST
      - name: CB_MCP_PORT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_PORT
      - name: CB_MCP_DISABLED_TOOLS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_DISABLED_TOOLS
      - name: CB_MCP_CONFIRMATION_REQUIRED_TOOLS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_CONFIRMATION_REQUIRED_TOOLS
      - name: CB_MCP_LOG_LEVEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_LEVEL
      - name: CB_MCP_LOG_SINKS
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_SINKS
      - name: CB_MCP_LOG_FILE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_FILE
      - name: CB_MCP_LOG_ROTATION_MAX_SIZE_MB
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_ROTATION_MAX_SIZE_MB
      - name: CB_MCP_LOG_MAX_BYTES
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_MAX_BYTES
      - name: CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_ERROR_ROTATION_MAX_SIZE_MB
      - name: CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_WARNING_ROTATION_MAX_SIZE_MB
      - name: CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_INFO_ROTATION_MAX_SIZE_MB
      - name: CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_DEBUG_ROTATION_MAX_SIZE_MB
      - name: CB_MCP_LOG_RETENTION_BACKUP_COUNT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_RETENTION_BACKUP_COUNT
      - name: CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_ERROR_RETENTION_BACKUP_COUNT
      - name: CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_WARNING_RETENTION_BACKUP_COUNT
      - name: CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_INFO_RETENTION_BACKUP_COUNT
      - name: CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_LOG_DEBUG_RETENTION_BACKUP_COUNT
      - name: CB_MCP_OAUTH_JWT_JWKS_URI
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_OAUTH_JWT_JWKS_URI
      - name: CB_MCP_OAUTH_JWT_ISSUER
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_OAUTH_JWT_ISSUER
      - name: CB_MCP_OAUTH_JWT_AUDIENCE
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_OAUTH_JWT_AUDIENCE
      - name: CB_MCP_OAUTH_JWT_ALGORITHM
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_OAUTH_JWT_ALGORITHM
      - name: CB_MCP_OAUTH_MCP_BASE_URL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_OAUTH_MCP_BASE_URL
      - name: CB_MCP_OAUTH_SCOPE_READ_LABEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_OAUTH_SCOPE_READ_LABEL
      - name: CB_MCP_OAUTH_SCOPE_WRITE_LABEL
        valueFrom:
          secretKeyRef:
            name: mcp-credentials
            key: CB_MCP_OAUTH_SCOPE_WRITE_LABEL
      command:
      - sh
      - -c
      - uvx mcp-proxy --host 0.0.0.0 --port 8000 --pass-environment -- uvx couchbase-mcp-server==1.0.1
      readinessProbe:
        httpGet:
          path: /status
          port: http
        initialDelaySeconds: 10

# helm install my-agent helm/my-agent -n mcp

    in the cloud

    one click: the provider's deploy form opens filled in, in your own account
    koyeb
    deploy to koyeb

    The form opens with CHANGE_ME for each value you supply: 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_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. Fill them in before you deploy.

    Clients connect to the service's https://…koyeb.app address plus /mcp.

    azure
    deploy to azuretemplate

    A Container Apps environment with one app per server, each with HTTPS ingress and one replica. The portal asks for each value you supply as a secure parameter; the deployment's outputs list the endpoints.

    connect to it

    copy what your client needs
    uvx couchbase-mcp-server==1.0.1
# env: 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_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
    {
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server==1.0.1"
      ],
      "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_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}"
      }
    }
  }
}
    #!/usr/bin/env bash
# Registers every server with Claude Code (run once; `claude mcp list` to check).
set -euo pipefail
set -a; [ -f .env ] && source .env; set +a
claude mcp add 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_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}" -- uvx couchbase-mcp-server==1.0.1

    {
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server==1.0.1"
      ],
      "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_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}"
      }
    }
  }
}
    {
  "servers": {
    "couchbase": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "couchbase-mcp-server==1.0.1"
      ],
      "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_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}"
      }
    }
  }
}
    name: my-agent
target: local
servers:
- hub: io.github.couchbase/mcp-server-couchbase
    • not probed yet: tools unpinned, ingest lists them

    tools

    Not probed yetThe tools appear once the hub or its worker has listed this entry. Running it still works: your client lists them on first start.