Couchbase-Ecosystem/mcp-server-couchbase

Overview

This MCP server enables AI agents to query and manipulate data in Couchbase clusters via the Model Context Protocol. It exposes Couchbase operations as tools that an LLM can call, using Python and the Couchbase SDK.

Best for

Best for
Developers building AI agents that need to read or write data in Couchbase clusters

Use cases

• Query documents in a Couchbase bucket using N1QL from an AI agent
• Insert or update JSON documents in a Couchbase cluster via natural language
• Retrieve and analyze data from Couchbase as part of a multi-step AI workflow

How to use

Install

uvx couchbase-mcp-server --disabled-tools upsert_document_by_id, delete_document_by_id

Tools exposed

• get_server_configuration_status
• test_cluster_connection
• get_cluster_health_and_services
• get_buckets_in_cluster
• get_scopes_in_bucket
• get_collections_in_scope
• get_scopes_and_collections_in_bucket
• get_schema_for_collection
• get_document_by_id
• upsert_document_by_id
• insert_document_by_id
• replace_document_by_id
• delete_document_by_id
• list_indexes
• get_index_advisor_recommendations
• run_sql_plus_plus_query
• explain_sql_plus_plus_query
• get_longest_running_queries
• get_most_frequent_queries
• get_queries_with_largest_response_sizes

Tested with

Claude Desktop, Cursor, Windsurf, VS Code

Example client config

{\n  "mcpServers": {\n    "couchbase": {\n      "command": "uvx",\n      "args": ["couchbase-mcp-server"],\n      "env": {\n        "CB_CONNECTION_STRING": "couchbases://connection-string",\n        "CB_USERNAME": "username",\n        "CB_PASSWORD": "password"\n      }\n    }\n  }\n}

Notes

This MCP server enables AI agents to query and manipulate data in Couchbase clusters via the Model Context Protocol. It exposes Couchbase operations as tools that an LLM can call, using Python and the Couchbase SDK.

32 stars on GitHub. Last updated 2026-06-01. Licensed Apache-2.0.

Use cases

• Query documents in a Couchbase bucket using N1QL from an AI agent
• Insert or update JSON documents in a Couchbase cluster via natural language
• Retrieve and analyze data from Couchbase as part of a multi-step AI workflow

Pros

• Direct integration with Couchbase’s document and SQL-like query capabilities
• Open source with a permissive license and active community
• Simple setup for developers already using Couchbase

Cons

• Limited to Couchbase ecosystems, not useful for other databases
• Relatively low community adoption with only 32 stars
• Requires a running Couchbase cluster and network access

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.