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

- 类型: MCP 工具
- 说明: 连接并操作 Couchbase 集群，支持查询、管理与数据库上下文调用。
- 仓库: https://github.com/couchbase/mcp-server-couchbase

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "io.github.couchbase/mcp-server-couchbase" MCP 服务：
执行：claude mcp add 'io-github-couchbase-mcp-server-couchbase' -- npx -y couchbase-mcp-server
```

### Codex
```
请帮我安装 askskill 上的 "io.github.couchbase/mcp-server-couchbase" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-couchbase-mcp-server-couchbase]
command = "npx"
args = ["-y","couchbase-mcp-server"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "io.github.couchbase/mcp-server-couchbase" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-couchbase-mcp-server-couchbase": { "command": "npx", "args": ["-y","couchbase-mcp-server"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --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_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 --transport stdio io-github-couchbase-mcp-server-couchbase -- npx -y couchbase-mcp-server
```
需要环境变量：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_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

### Codex
```bash
codex mcp add --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_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 io-github-couchbase-mcp-server-couchbase -- npx -y couchbase-mcp-server
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-couchbase-mcp-server-couchbase]
command = "npx"
args = ["-y","couchbase-mcp-server"]

[mcp_servers.io-github-couchbase-mcp-server-couchbase.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_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_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_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

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-couchbase-mcp-server-couchbase": {
      "command": "npx",
      "args": [
        "-y",
        "couchbase-mcp-server"
      ],
      "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_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"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-couchbase-mcp-server-couchbase&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImNvdWNoYmFzZS1tY3Atc2VydmVyIl0sImVudiI6eyJDQl9DT05ORUNUSU9OX1NUUklORyI6IllPVVJfVkFMVUUiLCJDQl9VU0VSTkFNRSI6IllPVVJfVkFMVUUiLCJDQl9QQVNTV09SRCI6IllPVVJfVkFMVUUiLCJDQl9DQV9DRVJUX1BBVEgiOiJZT1VSX1ZBTFVFIiwiQ0JfQ0xJRU5UX0NFUlRfUEFUSCI6IllPVVJfVkFMVUUiLCJDQl9DTElFTlRfS0VZX1BBVEgiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX1JFQURfT05MWV9NT0RFIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9UUkFOU1BPUlQiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX0hPU1QiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX1BPUlQiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX0RJU0FCTEVEX1RPT0xTIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9DT05GSVJNQVRJT05fUkVRVUlSRURfVE9PTFMiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX0xPR19MRVZFTCI6IllPVVJfVkFMVUUiLCJDQl9NQ1BfTE9HX1NJTktTIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9MT0dfRklMRSI6IllPVVJfVkFMVUUiLCJDQl9NQ1BfTE9HX1JPVEFUSU9OX01BWF9TSVpFX01CIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9MT0dfTUFYX0JZVEVTIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9MT0dfRVJST1JfUk9UQVRJT05fTUFYX1NJWkVfTUIiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX0xPR19XQVJOSU5HX1JPVEFUSU9OX01BWF9TSVpFX01CIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9MT0dfSU5GT19ST1RBVElPTl9NQVhfU0laRV9NQiI6IllPVVJfVkFMVUUiLCJDQl9NQ1BfTE9HX0RFQlVHX1JPVEFUSU9OX01BWF9TSVpFX01CIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9MT0dfUkVURU5USU9OX0JBQ0tVUF9DT1VOVCI6IllPVVJfVkFMVUUiLCJDQl9NQ1BfTE9HX0VSUk9SX1JFVEVOVElPTl9CQUNLVVBfQ09VTlQiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX0xPR19XQVJOSU5HX1JFVEVOVElPTl9CQUNLVVBfQ09VTlQiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX0xPR19JTkZPX1JFVEVOVElPTl9CQUNLVVBfQ09VTlQiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX0xPR19ERUJVR19SRVRFTlRJT05fQkFDS1VQX0NPVU5UIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9PQVVUSF9KV1RfSldLU19VUkkiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX09BVVRIX0pXVF9JU1NVRVIiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX09BVVRIX0pXVF9BVURJRU5DRSI6IllPVVJfVkFMVUUiLCJDQl9NQ1BfT0FVVEhfSldUX0FMR09SSVRITSI6IllPVVJfVkFMVUUiLCJDQl9NQ1BfT0FVVEhfTUNQX0JBU0VfVVJMIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9PQVVUSF9TQ09QRV9SRUFEX0xBQkVMIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9PQVVUSF9TQ09QRV9XUklURV9MQUJFTCI6IllPVVJfVkFMVUUifX0
需要环境变量：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_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