プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、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の3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンで動く
  • トランスポート: 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がつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

  • 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

  • このカテゴリのほかの32464件のうち0%よりスターが多い
  • このカテゴリのほかの32464件のうち89%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの32464件のうち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, yontu

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Remote Desktop Commander

作者:desktop-commander

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

クラウドで動く★ 211昨日更新
インストール

yontu

作者:senrecep

Türkçe yazı denetimi: TDK kuralları, yapay zekâ izleri, metin türüne göre üslup.

パソコンで動く今日更新
インストール

作者の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に聞く