Couchbase MCP Server (TypeScript/Bun Version)
Description
# Couchbase MCP Server (TypeScript/Bun Version) An [MCP](https://modelcontextprotocol.io/) server implementation of Couchbase that allows LLMs to directly interact with Couchbase clusters. This is a TypeScript/Bun implementation of the original Python MCP server. ## Features -…
About
# Couchbase MCP Server (TypeScript/Bun Version) An [MCP](https://modelcontextprotocol.io/) server implementation of Couchbase that allows LLMs to directly interact with Couchbase clusters. This is a TypeScript/Bun implementation of the original Python MCP server. ## Features - Get a list of all the scopes and…
Details
- Author
- zx8086
- Downloads
- 117
- Categories
- Other
Jump to
- 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.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Couchbase MCP Server (TypeScript/Bun Version)Command (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"couchbase mcp server (typescript/bun version)": {
"mcp-server-couchbase-zx8086": {
"command": "bun",
"args": [
"run",
"build"
]
}
}
}
}McpServers
{
"mcp-server-couchbase-zx8086": {
"command": "bun",
"args": [
"run",
"build"
]
}
}Couchbase MCP Server (TypeScript/Bun Version)
An MCP server implementation of Couchbase that allows LLMs to directly interact with Couchbase clusters. This is a TypeScript/Bun implementation of the original Python MCP server.
Features
- Get a list of all the scopes and collections in the specified bucket
- Get the structure for a collection
- Get a document by ID from a specified scope and collection
- Upsert a document by ID to a specified scope and collection
- Delete a document by ID from a specified scope and collection
- Run a SQL++ query on a specified scope
- There is an option in the MCP server, READ_ONLY_QUERY_MODE that is set to true by default to disable running SQL++ queries that change the data or the underlying collection structure. Note that the documents can still be updated by ID.
Prerequisites
- Bun 1.0 or higher
- A running Couchbase cluster. The easiest way to get started is to use Capella free tier, which is fully managed version of Couchbase server. You can follow instructions to import one of the sample datasets or import your own.
- An MCP client such as Claude Desktop installed to connect the server to Claude. The instructions are provided for Claude Desktop and Cursor. Other MCP clients could be used as well.
Configuration
Clone the repository to your local machine.
git clone https://github.com/yourusername/mcp-server-couchbase-bun.git
cd mcp-server-couchbase-bun
Install dependencies:
bun install
Build the TypeScript project:
bun run build
Create a .env file based on the example:
```bash
cp .env.example .env
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
