Couchbase-Ecosystem/mcp-server-couchbase
MCP Data & StorageAn MCP server implementation that lets large language models interact directly with Couchbase clusters
Features
- Provides API endpoints for cluster health checks and configuration status
- Enables schema discovery (buckets, scopes, collections, document schemas)
- Supports key‑value operations: get, upsert, insert, replace, delete documents
- Offers query and indexing tools including SQL++ execution and Index Advisor recommendations
Recent releases
View all 13 releases →
v0.7.0
Breaking risk
⚠ 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.
v0.6.0
New feature
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
v0.5.3
New feature
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
v0.5.2
Bug fix
Security fixes
- Potential fix for code scanning alert no. 6: Code injection
Notable features
- Enhance Docker workflow for version tagging in GitHub Actions
Full changelog
What's Changed
- MCP registry publishing by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/75
- MCP registry publishing #2 by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/76
- MCP Registry Publishing #3 by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/77
- Enhance Docker workflow for version tagging in GitHub Actions. by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/78
- Fix docker tags by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/79
- Fix docker latest tagging by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/80
- Potential fix for code scanning alert no. 6: Code injection by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/81
- Improve tool description for running SQL++ queries by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/82
- [Release 0.5.2] Update version to 0.5.2 in pyproject.toml, server.json, and uv.lock by @nithishr in https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/pull/83
Full Changelog: https://github.com/Couchbase-Ecosystem/mcp-server-couchbase/compare/v0.5.1...v0.5.2
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.
