What is the Couchbase MCP Server?

The Couchbase MCP Server is an implementation of the Model Context Protocol (MCP) that allows Large Language Models (LLMs) to directly interact with Couchbase clusters, enabling AI-powered data analysis, automation, and more.

What is the Model Context Protocol (MCP)?

MCP is an open protocol that standardizes how applications provide context to LLMs, allowing them to access and interact with external data sources and tools.

What are some use cases for the Couchbase MCP Server?

Use cases include AI-powered data analysis, intelligent automation, personalized recommendations, enhanced customer support, and dynamic content generation.

What features does the Couchbase MCP Server offer?

Key features include comprehensive data access, collection structure discovery, document retrieval and manipulation, SQL++ query execution, flexible deployment options, and seamless integration with MCP clients.

How do I configure the Couchbase MCP Server?

You can configure the server using environment variables such as CB_CONNECTION_STRING, CB_USERNAME, CB_PASSWORD, and CB_BUCKET_NAME.

What MCP clients are compatible with the Couchbase MCP Server?

Compatible clients include Claude Desktop, Cursor, and Windsurf Editor.

Can I run the Couchbase MCP Server in a Docker container?

Yes, the MCP server can be built and run as a Docker container. Prebuilt images are available on DockerHub.

What is READ_ONLY_QUERY_MODE?

This setting configures whether SQL++ queries that allow data to be modified are allowed. It is set to True by default to prevent unintended data modification. Documents can still be updated by ID.

Where can I find logs for Claude Desktop when using the Couchbase MCP Server?

On MacOS: ~/Library/Logs/Claude, On Windows: %APPDATA%ClaudeLogs

Where can I find logs for Cursor when using the Couchbase MCP Server?

In the bottom panel of Cursor, click on “Output” and select “Cursor MCP” from the dropdown menu.

What is UBOS, and how does it relate to the Couchbase MCP Server?

UBOS is a full-stack AI Agent Development Platform that helps you orchestrate AI Agents, connect them with enterprise data (including Couchbase via the MCP Server), and build custom AI Agents and Multi-Agent Systems.

What is the support policy for this project?

This project is community-maintained and not officially supported by the Couchbase support team. For help, bug reports, or contributions, please open a GitHub issue.

How can I use the Couchbase MCP server with Windsurf Editor?

In Windsurf Editor, navigate to Command Palette > Windsurf MCP Configuration Panel or Windsurf - Settings > Advanced > Cascade > Model Context Protocol (MCP) Servers. For more details on the configuration, please refer to the official documentation. Click on Add Server and then Add custom server. On the configuration that opens in the editor, add the Couchbase MCP Server configuration from above.