le. ```bash uvx couchbase-mcp-server \ --connection-string='' \ --username='' \ --password='' \ --bucket-name='' \ --read-only-query-mode=true \ --transport=http ``` The server will be available on http://localhost:8000/mcp. This can be used in MCP clients supporting streamable http transport mode such as Cursor. ### MCP Client Configuration ```json { "mcpServers": { "couchbase-http": { "url": "http://localhost:8000/mcp" } } } ``` ## SSE Transport Mode There is an option to run the MCP server in [Server-Sent Events (SSE)](https://modelcontextprotocol.io/specification/2024-11-05/basic/transports#http-with-sse) transport mode. > Note: SSE mode has been [deprecated](https://modelcontextprotocol.io/docs/concepts/transports#server-sent-events-sse-deprecated) by MCP. We have support for [Streamable HTTP](#streamable-http-transport-mode). ### Usage By default, the MCP server will run on port 8000 but this can be configured using the `--port` or `CB_MCP_PORT` environment variable. ```bash uvx couchbase-mcp-server \ --connection-string='' \ --username='' \ --password='' \ --bucket-name='' \ --read-only-query-mode=true \ --transport=sse ``` The server will be available on http://localhost:8000/sse. This can be used in MCP clients supporting SSE transport mode such as Cursor. ### MCP Client Configuration ```json { "mcpServers": { "couchbase-sse": { "url": "http://localhost:8000/sse" } } } ``` ## Docker Image The MCP server can also be built and run as a Docker container. Prebuilt images can be found on [DockerHub](https://hub.docker.com/r/couchbaseecosystem/mcp-server-couchbase). Alternatively, we are part of the [Docker MCP Catalog](https://hub.docker.com/mcp/server/couchbase/overview). ### Building Image ```bash docker build -t mcp/couchbase . ```

Building with Arguments

If you want to build with the build arguments for commit hash and the build time, you can build using: ```bash docker build --build-arg GIT_COMMIT_HASH=$(git rev-parse HEAD) \ --build-arg BUILD_DATE=$(date -u +'%Y-%m-%dT%H:%M:%SZ') \ -t mcp/couchbase . ``` **Alternatively, use the provided build script:** ```bash ./build.sh ``` This script automatically: - Generates git commit hash and build timestamp - Creates multiple useful tags (`latest`, ``) - Shows build information and results - Uses the same arguments as CI/CD builds **Verify image labels:** ```bash # View git commit hash in image docker inspect --format='{{index .Config.Labels "org.opencontainers.image.revision"}}' mcp/couchbase:latest # View all metadata labels docker inspect --format='{{json .Config.Labels}}' mcp/couchbase:latest ```

### Running The MCP server can be run with the environment variables being used to configure the Couchbase settings. The environment variables are the same as described in the [Configuration section](#server-configuration-for-mcp-clients). #### Independent Docker Container ```bash docker run --rm -i \ -e CB_CONNECTION_STRING='' \ -e CB_USERNAME='' \ -e CB_PASSWORD='' \ -e CB_BUCKET_NAME='' \ -e CB_MCP_TRANSPORT='' \ -e CB_MCP_READ_ONLY_QUERY_MODE='' \ -e CB_MCP_PORT=9001 \ -p 9001:9001 \ mcp/couchbase ``` The `CB_MCP_PORT` environment variable is only applicable in the case of HTTP transport modes like http and sse. #### MCP Client Configuration The Docker image can be used in `stdio` transport mode with the following configuration. ```json { "mcpServers": { "couchbase-mcp-docker": { "command": "docker", "args": [ "run", "--rm", "-i", "-e", "CB_CONNECTION_STRING=", "-e", "CB_USERNAME=", "-e",

#couchbase

🗄️ Couchbase MCP Server for LLMs

Couchbase MCP Server

Couchbase MCP Server