MCP.so
登录

Couchbase MCP Server

@Couchbase-Ecosystem

关于 Couchbase MCP Server

MCP Server to interact with data in Couchbase Clusters

基本信息

分类

其他

许可证

Apache-2.0

运行时

python

传输方式

stdio

发布者

Couchbase-Ecosystem

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "couchbase": {
      "command": "uvx",
      "args": [
        "couchbase-mcp-server"
      ],
      "env": {
        "CB_CONNECTION_STRING": "couchbases://connection-string",
        "CB_USERNAME": "username",
        "CB_PASSWORD": "password",
        "CB_BUCKET_NAME": "bucket_name"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Couchbase MCP Server?

Couchbase MCP Server is a self-hosted MCP server that allows AI agents to connect to and interact with data in Couchbase clusters, whether hosted on Capella or self-managed. It provides tools across categories including Cluster Health, Data Schema, Key-Value, Query, and Performance, with safety controls via read-only mode and fine-grained tool disabling.

How to use Couchbase MCP Server?

Install the server via PyPI (uvx couchbase-mcp-server) or Docker, or run from source. Configure it in an MCP client (e.g., Claude Desktop) by providing connection details (connection string, credentials or mTLS certificates) in the client’s mcpServers JSON. The server supports both STDIO and Streamable HTTP transports.

Key features of Couchbase MCP Server

  • Self-hosted; connects to Capella or self-managed Couchbase clusters
  • Tools: cluster health, schema discovery, KV operations, SQL++ queries
  • Performance analysis tools for query optimization
  • Read-only mode and per-tool disabling for safety control
  • Supports basic authentication and mTLS for secure connections
  • Distributed as PyPI package and Docker image

Use cases of Couchbase MCP Server

  • AI agents querying and managing documents in Couchbase buckets
  • Automated schema discovery for analytics or data cataloging
  • Performance monitoring and query optimization via SQL++ tools
  • Integrating Couchbase data into MCP-enabled LLM workflows

FAQ from Couchbase MCP Server

What are the prerequisites to run the server?

Python 3.10+, a running Couchbase cluster (Capella free tier works), uv installed, and an MCP client like Claude Desktop.

How do I authenticate the server to a Couchbase cluster?

Either provide username/password (CB_USERNAME, CB_PASSWORD) or use mTLS client certificate and key (CB_CLIENT_CERT_PATH, CB_CLIENT_KEY_PATH). The connection string is always required.

What is read-only mode?

When the environment variable CB_MCP_READ_ONLY_MODE is set to true, all KV write tools are disabled and SQL++ queries that modify data are blocked. This is the default setting.

Can I disable specific tools?

Yes, you can fine‑tune which tools are available by disabling individual tools through server configuration.

How is the server distributed and supported?

It is available as a PyPI package and via Docker. Enterprise support is available through licensing Couchbase AI Data Plane.

评论

其他 分类下的更多 MCP 服务器