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

- 类型: MCP 工具
- 说明: 连接并操作 Couchbase 集群，支持查询、管理与数据交互自动化。
- 仓库: https://github.com/Couchbase-Ecosystem/mcp-server-couchbase

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

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

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

### Cursor
```
请帮我安装 askskill 上的 "io.github.Couchbase-Ecosystem/mcp-server-couchbase" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-couchbase-ecosystem-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_READ_ONLY_QUERY_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 --transport stdio io-github-couchbase-ecosystem-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_READ_ONLY_QUERY_MODE, CB_MCP_TRANSPORT, CB_MCP_HOST, CB_MCP_PORT, CB_MCP_DISABLED_TOOLS, CB_MCP_CONFIRMATION_REQUIRED_TOOLS

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

[mcp_servers.io-github-couchbase-ecosystem-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_READ_ONLY_QUERY_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_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_READ_ONLY_QUERY_MODE, CB_MCP_TRANSPORT, CB_MCP_HOST, CB_MCP_PORT, CB_MCP_DISABLED_TOOLS, CB_MCP_CONFIRMATION_REQUIRED_TOOLS

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-couchbase-ecosystem-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_READ_ONLY_QUERY_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"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-couchbase-ecosystem-mcp-server-couchbase&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImNvdWNoYmFzZS1tY3Atc2VydmVyIl0sImVudiI6eyJDQl9DT05ORUNUSU9OX1NUUklORyI6IllPVVJfVkFMVUUiLCJDQl9VU0VSTkFNRSI6IllPVVJfVkFMVUUiLCJDQl9QQVNTV09SRCI6IllPVVJfVkFMVUUiLCJDQl9DQV9DRVJUX1BBVEgiOiJZT1VSX1ZBTFVFIiwiQ0JfQ0xJRU5UX0NFUlRfUEFUSCI6IllPVVJfVkFMVUUiLCJDQl9DTElFTlRfS0VZX1BBVEgiOiJZT1VSX1ZBTFVFIiwiQ0JfTUNQX1JFQURfT05MWV9NT0RFIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9SRUFEX09OTFlfUVVFUllfTU9ERSI6IllPVVJfVkFMVUUiLCJDQl9NQ1BfVFJBTlNQT1JUIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9IT1NUIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9QT1JUIjoiWU9VUl9WQUxVRSIsIkNCX01DUF9ESVNBQkxFRF9UT09MUyI6IllPVVJfVkFMVUUiLCJDQl9NQ1BfQ09ORklSTUFUSU9OX1JFUVVJUkVEX1RPT0xTIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：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_READ_ONLY_QUERY_MODE, CB_MCP_TRANSPORT, CB_MCP_HOST, CB_MCP_PORT, CB_MCP_DISABLED_TOOLS, CB_MCP_CONFIRMATION_REQUIRED_TOOLS