프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. 리뷰와 계정 기능은 다음 단계에서 열려요.
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

MCP Server Couchbase

제작자: couchbase버전 1.1.0i★ –i내 컴퓨터에서 실행
레지스트리 이름io.github.couchbase/mcp-server-couchbase

설치

개요

제작자가 쓴 설명(영어 원문)

Couchbase MCP servers: Operational and Operational Insights clusters.

PopNx MCP의 세 기둥

이 세 가지는 절대 하나의 점수로 합치지 않아요. 의견, 측정, 인기는 서로 다른 것이니까요.

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

  • 연결 방식: 내 컴퓨터에서 실행
  • 전송 방식: stdio
  • 카테고리: 기타
  • 입력해야 할 값: CB_PASSWORD, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

  • 기본 점검: 1개 중 1개 통과
  • 내 컴퓨터에서 내 사용자 계정의 권한(파일, 네트워크, 앱)으로 실행돼요.
  • 직접 입력할 값: 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

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

  • PyPIPython의 uv 설치(uvx 명령어용)

어떤 앱을 쓰세요?

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

Claude Desktop → Settings → Developer → Edit Config를 열고 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"
      }
    }
  }
}

터미널에서 이 명령어를 실행하세요

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

실행하기 전에 빈 값을 채워 주세요.

Cursor에서 열기

또는 설정을 직접 복사하기

프로젝트의 .cursor/mcp.json 또는 ~/.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"
      }
    }
  }
}

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

VS Code에서 열기

또는 설정을 직접 복사하기

프로젝트의 .vscode/mcp.json에 붙여 넣으세요

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

브라우저가 앱을 열지 물어본 다음, 앱이 설정을 보여 주고 확인을 요청해요. 키 값은 비워 두니 직접 입력하세요.

이 서버는 내 컴퓨터에서 실행되는데, ChatGPT는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

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

이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 6일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 couchbase 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • … 아직 점검 안 함

    계속 관리되고 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • … 아직 점검 안 함

    라이선스 있음

    아직 GitHub에서 이 저장소를 읽어 오지 않았어요

  • – 해당 없음

    엔드포인트 응답

    내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요

  • – 해당 없음

    OAuth로 로그인

    내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

기타 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 32433개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 32433개 중 89%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 32433개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

MCP Server Couchbase, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: CB_PASSWORD, CB_MCP_EMBEDDING_MODEL_API_KEY, CB_MCP_EMBEDDING_MODEL_AWS_ACCESS_KEY_ID, CB_MCP_EMBEDDING_MODEL_AWS_SECRET_ACCESS_KEY

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(1.1.0)은 4일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv), Docker도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Symantec Cloud DLP AIops

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Spec Driven Development

제작자: formulahendry

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

내 컴퓨터에서 실행★ 440MIT14개월 전 업데이트
설치

Remote Desktop Commander

제작자: desktop-commander

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

클라우드에서 실행★ 211어제 업데이트
설치

Symantec Cloud DLP AIops

제작자: AIops-tools

Governed Symantec Cloud DLP — 14 MCP tools, read-only with audit.

내 컴퓨터에서 실행오늘 업데이트
설치

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

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

앞부분만 보여 드려요. 나머지는 저장소에서 읽어 보세요

PopNx에게 묻기