Couchbase MCP Server (TypeScript/Bun Version)

What is Couchbase MCP Server (TypeScript/Bun Version)?

Couchbase MCP Server (TypeScript/Bun Version) is an MCP server implementation that allows LLMs to directly interact with Couchbase clusters. It is a TypeScript/Bun implementation of the original Python MCP server, providing type safety and better developer experience. It is intended for developers who want to enable AI assistants to perform operations on Couchbase data.

How to use Couchbase MCP Server (TypeScript/Bun Version)?

Clone the repository, install dependencies with bun install, build with bun run build, and create a .env file with Couchbase credentials. Then configure an MCP client (e.g., Claude Desktop) with a JSON entry pointing to bun and the built script, passing environment variables for connection string, username, password, bucket name, and optionally READ_ONLY_QUERY_MODE. Run with bun run dev (development) or bun run start (production). For SSE transport, use bun run dev:sse or bun run start:sse.

Key features of Couchbase MCP Server (TypeScript/Bun Version)

• Get a list of all scopes and collections in a specified bucket.
• Get the structure for a collection.
• Get, upsert, and delete documents by ID in a specified scope and collection.
• Run SQL++ queries on a specified scope (read-only by default).
• Optional read-only query mode to prevent data modification.
• Runs on the Bun runtime for performance.
• Supports both stdio and SSE transport modes.
• Can be run as a Docker container.

Use cases of Couchbase MCP Server (TypeScript/Bun Version)

• Allow an LLM-powered assistant to retrieve documents from a Couchbase bucket.
• Enable an AI agent to insert or update documents by ID in a collection.
• Let an LLM explore collection structures and scopes within a bucket.
• Run analytical or read-only SQL++ queries from an AI chat interface.

FAQ from Couchbase MCP Server (TypeScript/Bun Version)

What prerequisites are needed?

Bun 1.0 or higher, a running Couchbase cluster (Capella free tier is recommended), and an MCP client such as Claude Desktop.

Can I prevent SQL++ queries from modifying data?

Yes. The server has a READ_ONLY_QUERY_MODE environment variable set to true by default, which disables SQL++ queries that change data or collection structure.

Where are my Couchbase credentials stored?

Credentials are provided via environment variables in the MCP client configuration (or .env file locally). No credentials are stored in the server itself.

Does this server support SSE transport?

Yes. Use the --transport=sse flag or the dev:sse / start:sse scripts. The server listens on port 8080 by default, configurable via FASTMCP_PORT.

Is this server officially supported by Couchbase?

No. This project is community-maintained and not officially supported. Support is provided via GitHub issues.