# io.github.couchbase/mcp-server-couchbase

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

- name: io.github.couchbase/mcp-server-couchbase
- version: 1.0.1
- connection class: L0 (run_local_package)
- trust: 90/100
- quality: –/100 (not scored)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.couchbase%2Fmcp-server-couchbase
- tools: https://api.protogrid.dev/v1/servers/io.github.couchbase%2Fmcp-server-couchbase/tools

**Runs on your machine: something must execute the package.** Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server==1.0.1",
        "--connection-string",
        "--username",
        "--password",
        "${PASSWORD}",
        "--ca-cert-path",
        "--client-cert-path",
        "--client-key-path",
        "--read-only-mode",
        "--transport",
        "--host",
        "--port",
        "--disabled-tools",
        "--confirmation-required-tools",
        "--log-level",
        "--log-sinks",
        "--log-file",
        "--log-rotation-max-size-mb",
        "--log-max-bytes",
        "--log-error-rotation-max-size-mb",
        "--log-warning-rotation-max-size-mb",
        "--log-info-rotation-max-size-mb",
        "--log-debug-rotation-max-size-mb",
        "--log-retention-backup-count",
        "--log-error-retention-backup-count",
        "--log-warning-retention-backup-count",
        "--log-info-retention-backup-count",
        "--log-debug-retention-backup-count",
        "--oauth-jwks-uri",
        "--oauth-issuer",
        "--oauth-audience",
        "--oauth-algorithm",
        "--oauth-mcp-base-url",
        "--oauth-scope-read-label",
        "--oauth-scope-write-label"
      ],
      "env": {
        "CB_PASSWORD": "${CB_PASSWORD}"
      }
    }
  }
}
```

Placeholders to fill: `${CB_PASSWORD}`, `${PASSWORD}`.

## Trust

- hygiene: 95
- liveness: n/a
- freshness: 85
- provenance: 90
- drivers: +repository +namespace-matches-repo +website ~liveness-unmeasured ~updated-68d-ago -unpinned-packages(1)
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality –/100 (not scored)

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: n/a (weight 30)

- n/a `tools.descriptions`, `tools.description_length`, `tools.schemas`, `tools.annotations`, `tools.directory_hints`, `tools.token_cost`, `tools.api_dump`: tool list unknown (behind auth, not probed, or empty)

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool list unknown

### dependencies: 83 (weight 15)

- warn `deps.known_vulns`: 1 advisory of lower severity or without a published fix: PYSEC-2023-235 in couchbase@4.6.3 (direct, no fix yet)
- pass `deps.mcp_sdk_version`: mcp 1.30.0, no known advisory
- pass `deps.resolvable`: couchbase-mcp-server@1.0.1 resolved: 73 packages

- tools: unknown
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.couchbase/mcp-server-couchbase.svg)](https://protogrid.dev/servers/io.github.couchbase/mcp-server-couchbase)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- pypi couchbase-mcp-server@1.0.1: resolved, 72 dependencies, MCP SDK mcp 1.30.0
  - PYSEC-2023-235 (unrated) in `` couchbase@4.6.3 ``, direct, no fix yet, advisory summary: "An issue was discovered in Couchbase Server 7.2.0. There is a private key leak in debug.log while adding a pre-7.0 node to a 7.2 cluster." https://osv.dev/vulnerability/PYSEC-2023-235

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

_none_

## Packages

- pypi couchbase-mcp-server@1.0.1 secrets: CB_PASSWORD, --password
- oci docker.io/couchbase/mcp-server:1.0.1 secrets: CB_PASSWORD

## Tools (0)

_none observed_