An MCP server implementation of Couchbase that allows LLMs to directly interact with Couchbase clusters.
Couchbase MCP Server (TypeScript/Bun Version) is an MCP project maintained in the zx8086/mcp-server-couchbase repository. The maintainer describes its purpose as “An MCP server implementation of Couchbase that allows LLMs to directly interact with Couchbase clusters”. Read the project documentation for the complete scope.
The project provides a local client configuration using bun. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares COUCHBASE_URL, COUCHBASE_USERNAME, COUCHBASE_PASSWORD, COUCHBASE_BUCKET, COUCHBASE_SCOPE, COUCHBASE_COLLECTION, LOG_LEVEL, DOCS_ENABLED, DOCS_BASE_DIR, DOCS_FILE_EXT, PWD, PATH. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| get_scopes_and_collections | List all scopes and collections in the specified bucket |
| get_schema_for_collection | Get the structure and schema for a specific collection |
| get_document_by_id | Retrieve a document by ID from a specified scope and collection |
| upsert_document_by_id | Create or update a document by ID in a specified scope and collection |
| delete_document_by_id | Remove a document by ID from a specified scope and collection |
| run_sql_plus_plus_query | Execute SQL++ queries on a specified scope |
| get_detailed_indexes | Get comprehensive information about database indexes |
| get_detailed_prepared_statements | View detailed information about prepared statements |
| get_system_vitals | Monitor system health metrics |
| get_system_nodes | View information about cluster nodes |
| get_most_expensive_queries | Identify queries with highest resource consumption |
| suggest_query_optimizations | Get recommendations for query performance improvements |
| analyze_document_structure | Analyze and understand document structure patterns |
| get_document_type_examples | View example documents for different types |
| get_prepared_statements | List all prepared statements |
| get_indexes_to_drop | Identify unused or redundant indexes |
| get_completed_requests | View completed query requests |
| get_system_indexes | List all system indexes |
| get_primary_index_queries | Identify queries using primary indexes |
| get_largest_result_count_queries | Find queries returning the most results |
| get_largest_result_size_queries | Identify queries with largest result sizes |
| get_most_frequent_queries | View most commonly executed queries |
| get_longest_running_queries | Identify queries with longest execution times |
| get_fatal_requests | View failed query requests |
| list_documentation | List available documentation for the MCP server tools and features |
| read_documentation | Read specific documentation entries |
| create_documentation | Create new documentation entries for tools and features |
| delete_documentation | Remove documentation entries |
| sync_documentation | Synchronize and update existing documentation |
| list_playbooks | List available playbooks for database operations |
{
"mcpServers": {
"couchbase-capella-mcp": {
"command": "bun",
"args": [
"/path/to/your/mcp-server-couchbase/dist/index.js",
"--transport",
"stdio"
],
"env": {
"COUCHBASE_URL": "couchbases://your-cluster-url",
"COUCHBASE_USERNAME": "your-username",
"COUCHBASE_PASSWORD": "YOUR_COUCHBASE_PASSWORD",
"COUCHBASE_BUCKET": "your-bucket",
"COUCHBASE_SCOPE": "your-scope",
"COUCHBASE_COLLECTION": "your-collection",
"LOG_LEVEL": "debug",
"DOCS_ENABLED": "true",
"DOCS_BASE_DIR": "/path/to/your/mcp-server-couchbase/docs",
"DOCS_FILE_EXT": ".md",
"PWD": "/path/to/your/mcp-server-couchbase",
"PATH": "/Users/your-username/.bun/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin"
},
"cwd": "/path/to/your/mcp-server-couchbase"
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| COUCHBASE_URL | Declared in the maintainer’s client configuration. | Check documentation |
| COUCHBASE_USERNAME | Declared in the maintainer’s client configuration. | Check documentation |
| COUCHBASE_PASSWORD | Declared in the maintainer’s client configuration. | Check documentation |
| COUCHBASE_BUCKET | Declared in the maintainer’s client configuration. | Check documentation |
| COUCHBASE_SCOPE | Declared in the maintainer’s client configuration. | Check documentation |
| COUCHBASE_COLLECTION | Declared in the maintainer’s client configuration. | Check documentation |
| LOG_LEVEL | Declared in the maintainer’s client configuration. | Check documentation |
| DOCS_ENABLED | Declared in the maintainer’s client configuration. | Check documentation |
| DOCS_BASE_DIR | Declared in the maintainer’s client configuration. | Check documentation |
| DOCS_FILE_EXT | Declared in the maintainer’s client configuration. | Check documentation |
| PWD | Declared in the maintainer’s client configuration. | Check documentation |
| PATH | Declared in the maintainer’s client configuration. | Check documentation |
Inspect PostgreSQL schemas and run read-only queries with the archived MCP reference server. Review its maintenance status before choosing it.
Connect the Notion MCP server to search workspace content and work with pages and databases through Notion’s hosted OAuth service.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Official MongoDB server covering data, schemas and Atlas management — from find queries to spinning up clusters.