Couchbase-Ecosystem/mcp-server-couchbase

MCP Data & Storage

A self‑hosted MCP server that lets AI agents query and manipulate data in Couchbase clusters via standardized tools

Track releases GitHub Website

Python Latest v1.0.0.post1 · 26d ago Security brief →

Features

Cluster health checks (status, services, connection validation)
Schema discovery (buckets, scopes, collections, collection schema)
Key‑value document operations (read, upsert, insert, replace) with configurable read‑only safety

Recent releases

View all 16 releases →

Review required

v1.0.0 Breaking risk 1mo

Auth RBAC

Read-only query removal

Open

No immediate action

v0.8.0 New feature 2mo

Indexes tool for Couchbase 8.0

Open

v0.7.0 Breaking risk 3mo

⚠ Upgrade required

Update Docker readme and build script.
Contribution guide updated (DA-1626).
Delete is no longer default in Elicitation (DA-1616).

Breaking changes

Removed urllib3 since the underlying dependency no longer exists.

Notable features

Added Explain Plan for queries (DA-1537)
Added support for Elicitation (DA-1575)
Added installation links for Cursor (DA-1572)

Full changelog

What's Changed

Add Scarf gateway as Docker pull option by @azaddhirajkumar in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/107
Update Docker readme by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/108
DA-1537 Added Explain Plan for the query by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/105
DA-1575 Added Support for Elicitation by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/111
Bump mcp from 1.20.0 to 1.23.0 by @dependabot[bot] in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/95
DA-1528 Removed urllib3 since dependency no longer exist by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/112
DA-1616 Remove delete as default in Elicitation by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/113
DA-1626 contribution guide update by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/116
DA-1572 Added Installation links for Cursor by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/118
Update build script & cleanup by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/119
Update contribution guidelines for dependency management and formatting by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/121

New Contributors

@azaddhirajkumar made their first contribution in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/107
@dependabot[bot] made their first contribution in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/95

Full Changelog: https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/compare/v0.6.1...v0.7.0

Note: The tool call for test_cluster_connection has a bug (#127) with the Couchbase Python SDK 4.6.0. The solution is to downgrade the SDK version in the MCP server to 4.5.0 or upgrade the MCP server to version 0.7.1.

View release on GitHub

v0.6.0 New feature 5mo

Notable features

Added Update Insert and Replace operations to KV
Disabled individual tools from being used by the agent (DA-1476)
Updated mcp server readonly mode (Da-1437)

Full changelog

What's Changed

Update README with new instructions for VSCode and JetBrains by @Mani-Kuriseti in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/89
DA-1452: Added Update Insert and Replace in KV operations by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/90
Updated README to include the tool names by @Mani-Kuriseti in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/91
DA-1476 disable individual tools from being used by agent by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/92
Da-1437: mcp server readonly mode update by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/93

New Contributors

@Mani-Kuriseti made their first contribution in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/89

Full Changelog: https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/compare/v0.5.3...v0.6.0

View release on GitHub

v0.5.3 New feature 7mo

Notable features

Added `get_longest_running_queries` to list top N longest running queries by average service time
Added `get_most_frequent_queries` to list top N most frequently executed queries
Added `get_queries_with_largest_response_sizes` to find queries with largest average response sizes (bytes/KB/MB)

Full changelog

What's Changed

Query Performance Analysis Tools (7 tools)
| Tool | Description |
|------|-------------|
| get_longest_running_queries | Get top N longest running queries by average service time |
| get_most_frequent_queries | Get top N most frequently executed queries |
| get_queries_with_largest_response_sizes | Find queries with the largest average response sizes (bytes/KB/MB) |
| get_queries_with_large_result_count | Find queries returning the most documents on average |
| get_queries_using_primary_index | Identify queries using primary indexes (performance anti-pattern) |
| get_queries_not_using_covering_index | Find queries requiring document fetches after index scans |
| get_queries_not_selective | Detect queries where index scans return significantly more documents than needed |
This release cover comprehensive testing strategy:

Tools independently - Integration tests for each tool
Utilities - Unit tests for index_utils, constants, config, connection, context
Configuration - Settings and validation testing
MCP server integration - Protocol compliance, tool registration
Tool loading - Verification that all expected tools are registered
Demo cluster invocation - Live cluster testing support

Full Changelog: https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/compare/v0.5.2...v0.5.3

What's Changed

DA-1203 Modified Add Slow Running Queries tools by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/74
DA-1055 investigate automated testing for tools mcp server by @AayushTyagi1 in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/86

Full Changelog: https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/compare/v0.5.2...v0.5.3

View release on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.