AgentHubAgentHub

mcp-server-couchbase

MCP ServerMCP Registry官方收录

io.github.Couchbase-Ecosystem/mcp-server-couchbase · v0.8.0

Couchbase Model Context Protocol Server to interact with Couchbase clusters

源仓库 ↗

概览

mcp-server-couchbase 是一个MCP Server，收录自 官方 MCP Registry。支持 stdio 传输。本页提供 Cursor、Claude Code 等客户端的安装配置片段。

安装

选择你的平台查看安装方式

{
  "mcpServers": {
    "mcp-server-couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ]
    }
  }
}

环境变量

CB_CONNECTION_STRING可选

Couchbase connection string. Required for connecting to the cluster.

CB_USERNAME可选

Couchbase database username. Required for basic authentication.

CB_PASSWORD可选secret

Couchbase database password. Required for basic authentication.

CB_CA_CERT_PATH可选

Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.

CB_CLIENT_CERT_PATH可选

Couchbase client certificate path. Required for mTLS authentication.

CB_CLIENT_KEY_PATH可选

Couchbase client key path. Required for mTLS authentication.

CB_MCP_READ_ONLY_MODE可选

Couchbase read only mode. Set to true to allow disable write operations across both KV and query. KV write tools are not loaded and SQL++ queries that modify data are blocked. Set to false to allow data modification queries and tools.

CB_MCP_READ_ONLY_QUERY_MODE可选

[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead.

CB_MCP_TRANSPORT可选

Transport mode for the server (stdio, http or sse). Default is stdio

CB_MCP_HOST可选

Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.

CB_MCP_PORT可选

Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.

CB_MCP_DISABLED_TOOLS可选

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可选

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_CONNECTION_STRING可选

Couchbase connection string. Required for connecting to the cluster.

CB_USERNAME可选

Couchbase database username. Required for basic authentication.

CB_PASSWORD可选secret

Couchbase database password. Required for basic authentication.

CB_CA_CERT_PATH可选

Couchbase CA certificate path. Required for TLS authentication in non Capella clusters.

CB_CLIENT_CERT_PATH可选

Couchbase client certificate path. Required for mTLS authentication.

CB_CLIENT_KEY_PATH可选

Couchbase client key path. Required for mTLS authentication.

CB_MCP_READ_ONLY_MODE可选

Couchbase read only mode. Set to true to disable write operations across both KV and query. KV write tools are not loaded and SQL++ queries that modify data are blocked. Set to false to allow data modification queries and tools.

CB_MCP_READ_ONLY_QUERY_MODE可选

[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead.

CB_MCP_TRANSPORT可选

Transport mode for the server (stdio, http or sse). Default is stdio

CB_MCP_HOST可选

Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes.

CB_MCP_PORT可选

Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes.

CB_MCP_DISABLED_TOOLS可选

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可选

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.

相关资源

统一 Manifest

{
  "id": "io.github.Couchbase-Ecosystem/mcp-server-couchbase",
  "type": "mcp-server",
  "version": "0.8.0",
  "displayName": "mcp-server-couchbase",
  "description": "Couchbase Model Context Protocol Server to interact with Couchbase clusters",
  "repository": {
    "url": "https://github.com/Couchbase-Ecosystem/mcp-server-couchbase",
    "source": "github"
  },
  "distribution": {
    "packages": [
      {
        "registryType": "pypi",
        "identifier": "couchbase-mcp-server",
        "version": "0.8.0",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "CB_CONNECTION_STRING",
            "description": "Couchbase connection string. Required for connecting to the cluster."
          },
          {
            "name": "CB_USERNAME",
            "description": "Couchbase database username. Required for basic authentication."
          },
          {
            "name": "CB_PASSWORD",
            "description": "Couchbase database password. Required for basic authentication.",
            "isSecret": true
          },
          {
            "name": "CB_CA_CERT_PATH",
            "description": "Couchbase CA certificate path. Required for TLS authentication in non Capella clusters."
          },
          {
            "name": "CB_CLIENT_CERT_PATH",
            "description": "Couchbase client certificate path. Required for mTLS authentication."
          },
          {
            "name": "CB_CLIENT_KEY_PATH",
            "description": "Couchbase client key path. Required for mTLS authentication."
          },
          {
            "name": "CB_MCP_READ_ONLY_MODE",
            "description": "Couchbase read only mode. Set to true to allow disable write operations across both KV and query. KV write tools are not loaded and SQL++ queries that modify data are blocked. Set to false to allow data modification queries and tools."
          },
          {
            "name": "CB_MCP_READ_ONLY_QUERY_MODE",
            "description": "[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead."
          },
          {
            "name": "CB_MCP_TRANSPORT",
            "description": "Transport mode for the server (stdio, http or sse). Default is stdio"
          },
          {
            "name": "CB_MCP_HOST",
            "description": "Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes."
          },
          {
            "name": "CB_MCP_PORT",
            "description": "Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes."
          },
          {
            "name": "CB_MCP_DISABLED_TOOLS",
            "description": "Tools to disable. Accepts comma-separated tool names (e.g., 'tool_1,tool_2') or a file path containing one tool name per line."
          },
          {
            "name": "CB_MCP_CONFIRMATION_REQUIRED_TOOLS",
            "description": "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."
          }
        ]
      },
      {
        "registryType": "oci",
        "identifier": "docker.io/couchbaseecosystem/mcp-server-couchbase:0.8.0",
        "transport": "stdio",
        "environmentVariables": [
          {
            "name": "CB_CONNECTION_STRING",
            "description": "Couchbase connection string. Required for connecting to the cluster."
          },
          {
            "name": "CB_USERNAME",
            "description": "Couchbase database username. Required for basic authentication."
          },
          {
            "name": "CB_PASSWORD",
            "description": "Couchbase database password. Required for basic authentication.",
            "isSecret": true
          },
          {
            "name": "CB_CA_CERT_PATH",
            "description": "Couchbase CA certificate path. Required for TLS authentication in non Capella clusters."
          },
          {
            "name": "CB_CLIENT_CERT_PATH",
            "description": "Couchbase client certificate path. Required for mTLS authentication."
          },
          {
            "name": "CB_CLIENT_KEY_PATH",
            "description": "Couchbase client key path. Required for mTLS authentication."
          },
          {
            "name": "CB_MCP_READ_ONLY_MODE",
            "description": "Couchbase read only mode. Set to true to disable write operations across both KV and query. KV write tools are not loaded and SQL++ queries that modify data are blocked. Set to false to allow data modification queries and tools."
          },
          {
            "name": "CB_MCP_READ_ONLY_QUERY_MODE",
            "description": "[Deprecated] Couchbase read only query mode. Set to true to allow only read-only queries. Set to false to allow data modification queries. Use CB_MCP_READ_ONLY_MODE instead."
          },
          {
            "name": "CB_MCP_TRANSPORT",
            "description": "Transport mode for the server (stdio, http or sse). Default is stdio"
          },
          {
            "name": "CB_MCP_HOST",
            "description": "Host to run the MCP server on (default: 127.0.0.1). Used only for HTTP and SSE transport modes."
          },
          {
            "name": "CB_MCP_PORT",
            "description": "Port to run the MCP server on (default: 8000). Used only for HTTP and SSE transport modes."
          },
          {
            "name": "CB_MCP_DISABLED_TOOLS",
            "description": "Tools to disable. Accepts comma-separated tool names (e.g., 'tool_1,tool_2') or a file path containing one tool name per line."
          },
          {
            "name": "CB_MCP_CONFIRMATION_REQUIRED_TOOLS",
            "description": "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."
          }
        ]
      }
    ],
    "remotes": []
  },
  "dependencies": [],
  "installTargets": [
    "claude-code",
    "claude-desktop",
    "cursor",
    "vscode"
  ],
  "keywords": [],
  "provenance": {
    "origin": "official-mcp-registry",
    "originalId": "io.github.Couchbase-Ecosystem/mcp-server-couchbase",
    "originalUrl": "https://registry.modelcontextprotocol.io/v0.1/servers/io.github.Couchbase-Ecosystem%2Fmcp-server-couchbase/versions/latest",
    "isOfficial": true,
    "status": "active"
  }
}
mcp-server-couchbase — MCP Server 安装与配置 · AgentHub