Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uvx",
      "args": [
        "couchbase-guru==0.1.0",
        "--transport",
        "--host",
        "--port",
        "--agent-base-url",
        "--agent-ip-salt",
        "${AGENT_IP_SALT}"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "${CB_AGENT_IP_SALT}"
      }
    }
  }
}

claude mcp add couchbase-guru -e "CB_AGENT_IP_SALT=${CB_AGENT_IP_SALT}" -- uvx couchbase-guru==0.1.0 --transport --host --port --agent-base-url --agent-ip-salt "${AGENT_IP_SALT}"

[mcp_servers.couchbase-guru]
command = "uvx"
args = ["couchbase-guru==0.1.0", "--transport", "--host", "--port", "--agent-base-url", "--agent-ip-salt", "${AGENT_IP_SALT}"]
env = { "CB_AGENT_IP_SALT" = "${CB_AGENT_IP_SALT}" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "couchbase-guru": {
      "type": "local",
      "command": [
        "uvx",
        "couchbase-guru==0.1.0",
        "--transport",
        "--host",
        "--port",
        "--agent-base-url",
        "--agent-ip-salt",
        "{env:AGENT_IP_SALT}"
      ],
      "enabled": true,
      "environment": {
        "CB_AGENT_IP_SALT": "{env:CB_AGENT_IP_SALT}"
      }
    }
  }
}

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uvx",
      "args": [
        "couchbase-guru==0.1.0",
        "--transport",
        "--host",
        "--port",
        "--agent-base-url",
        "--agent-ip-salt",
        "${AGENT_IP_SALT}"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "${CB_AGENT_IP_SALT}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=couchbase-guru&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJjb3VjaGJhc2UtZ3VydT09MC4xLjAiLCItLXRyYW5zcG9ydCIsIi0taG9zdCIsIi0tcG9ydCIsIi0tYWdlbnQtYmFzZS11cmwiLCItLWFnZW50LWlwLXNhbHQiLCIke0FHRU5UX0lQX1NBTFR9Il0sImVudiI6eyJDQl9BR0VOVF9JUF9TQUxUIjoiJHtDQl9BR0VOVF9JUF9TQUxUfSJ9fQ%3D%3D"
}

{
  "servers": {
    "couchbase-guru": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "couchbase-guru==0.1.0",
        "--transport",
        "--host",
        "--port",
        "--agent-base-url",
        "--agent-ip-salt",
        "${AGENT_IP_SALT}"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "${CB_AGENT_IP_SALT}"
      }
    }
  }
}

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uvx",
      "args": [
        "couchbase-guru==0.1.0",
        "--transport",
        "--host",
        "--port",
        "--agent-base-url",
        "--agent-ip-salt",
        "${AGENT_IP_SALT}"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "${CB_AGENT_IP_SALT}"
      }
    }
  }
}

extensions:
  "couchbase-guru":
    enabled: true
    name: "couchbase-guru"
    type: stdio
    cmd: "uvx"
    args:
      - "couchbase-guru==0.1.0"
      - "--transport"
      - "--host"
      - "--port"
      - "--agent-base-url"
      - "--agent-ip-salt"
      - "${AGENT_IP_SALT}"
    envs:
      "CB_AGENT_IP_SALT": "${CB_AGENT_IP_SALT}"
    timeout: 300

Placeholders to fill from your own secret store: ${CB_AGENT_IP_SALT}, ${AGENT_IP_SALT}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

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

protocoln/a · weight 25

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

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependencies100 · weight 15

pass
deps.known_vulnsno known advisory in 69 resolved packages
pass
deps.mcp_sdk_versionmcp 1.30.0, no known advisory
pass
deps.resolvable[email protected] resolved: 69 packages

Tool list unknown · checked 2026-10-19 21:10 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 86 / 100

provenance80

livenessn/a

freshness85

hygiene95

+repository +namespace-matches-repo ~liveness-unmeasured ~updated-53d-ago -unpinned-packages(1)

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPI68 dependencies, resolved · MCP SDK mcp 1.30.0 · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`couchbase-guru`	pypi	0.1.0	–	`CB_AGENT_IP_SALT`, `--agent-ip-salt`
`docker.io/couchbaseecosystem/couchbase-guru:0.1.0`	oci	unpinned	–	`CB_AGENT_IP_SALT`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.Couchbase-Ecosystem/couchbase-guru",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.1.0",
  "packages": [
    {
      "version": "0.1.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "couchbase-guru",
      "registryType": "pypi",
      "packageArguments": [
        {
          "name": "--transport",
          "type": "named",
          "format": "string",
          "description": "Transport mode for the server (stdio or http). Default is stdio."
        },
        {
          "name": "--host",
          "type": "named",
          "format": "string",
          "description": "Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP transport mode."
        },
        {
          "name": "--port",
          "type": "named",
          "format": "number",
          "description": "Port to run the MCP server on (default: 8000). Used only for HTTP transport mode."
        },
        {
          "name": "--agent-base-url",
          "type": "named",
          "format": "string",
          "description": "Base URL of the documentation agent backend. Set this to run against your own self-hosted agent; if unset, the public agent is used."
        },
        {
          "name": "--agent-ip-salt",
          "type": "named",
          "format": "string",
          "isSecret": true,
          "description": "Secret salt used to pseudonymize client IPs (HTTP transport). Set a shared value for consistent hashing across multiple instances; a local salt is generated when unset."
        }
      ],
      "environmentVariables": [
        {
          "name": "CB_MCP_TRANSPORT",
          "format": "string",
          "description": "Transport mode for the server (stdio or http). Default is stdio."
        },
        {
          "name": "CB_MCP_HOST",
          "format": "string",
          "description": "Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP transport mode."
        },
        {
          "name": "CB_MCP_PORT",
          "format": "number",
          "description": "Port to run the MCP server on (default: 8000). Used only for HTTP transport mode."
        },
        {
          "name": "CB_AGENT_BASE_URL",
          "format": "string",
          "description": "Base URL of the documentation agent backend. Set this to run against your own self-hosted agent; if unset, the public agent is used."
        },
        {
          "name": "CB_AGENT_IP_SALT",
          "format": "string",
          "isSecret": true,
          "description": "Secret salt used to pseudonymize client IPs (HTTP transport). Set a shared value for consistent hashing across multiple instances; a local salt is generated when unset."
        }
      ]
    },
    {
      "transport": {
        "type": "stdio"
      },
      "identifier": "docker.io/couchbaseecosystem/couchbase-guru:0.1.0",
      "registryType": "oci",
      "environmentVariables": [
        {
          "name": "CB_MCP_TRANSPORT",
          "format": "string",
          "description": "Transport mode for the server (stdio or http). Default is stdio."
        },
        {
          "name": "CB_MCP_HOST",
          "format": "string",
          "description": "Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP transport mode."
        },
        {
          "name": "CB_MCP_PORT",
          "format": "number",
          "description": "Port to run the MCP server on (default: 8000). Used only for HTTP transport mode."
        },
        {
          "name": "CB_AGENT_BASE_URL",
          "format": "string",
          "description": "Base URL of the documentation agent backend. Set this to run against your own self-hosted agent; if unset, the public agent is used."
        },
        {
          "name": "CB_AGENT_IP_SALT",
          "format": "string",
          "isSecret": true,
          "description": "Secret salt used to pseudonymize client IPs (HTTP transport). Set a shared value for consistent hashing across multiple instances; a local salt is generated when unset."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/Couchbase-Ecosystem/couchbase-guru",
    "source": "github"
  },
  "description": "Search the Couchbase documentation from your MCP client via a hosted documentation agent."
}