Couchbase MCP Server (TypeScript/Bun Version)

@zx8086

About Couchbase MCP Server (TypeScript/Bun Version)

No overview available yet

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-couchbase-zx8086": {
      "command": "bun",
      "args": [
        "run",
        "build"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Frequently asked questions

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.

Comments

Basic information

More Other MCP servers

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K