Skip to content
mcp/harbor
Windsurf

mcp server couchbase for Windsurf

io.github.couchbase/mcp-server-couchbase

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

client:Windsurf transport:stdio runtime:pypi

Install mcp server couchbase in Windsurf

~/.codeium/windsurf/mcp_config.json · windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Held in this page only — never stored, logged, or sent anywhere but back to your screen. 

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "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>"
      }
    }
  }
}

Global only — Windsurf has no per-project MCP config. Refresh Cascade after saving. Windsurf docs

mcp server couchbase in other clients

mcp server couchbase MCP server