Couchbase Guru MCP server

Couchbase Guru MCP Server

An MCP server that lets LLMs search the Couchbase documentation from your MCP client. It exposes a single tool, askcouchbasedocs, which forwards your question to a hosted retrieval-augmented (RAG) documentation agent and returns an answer with source links.

<!-- mcp-name: io.github.Couchbase-Ecosystem/couchbase-guru -->

No Couchbase cluster or credentials required. The server talks only to the documentation agent backend, not to your data.

Tool

Ask complete, self-contained questions — the backend has no conversation history, so include the product, version, and language where relevant (e.g. "How do I create a primary index with the Python SDK in Couchbase Server 7.6?").

Prerequisites

• Python 3.10 or higher.
• uv installed to run the server.
• An MCP client such as Claude Desktop, Cursor, or VS Code.

Configuration

The server can be run from the prebuilt PyPI package or from source with uv. It works with zero configuration — the public documentation agent is used by default.

Running from PyPI

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uvx",
      "args": ["couchbase-guru"]
    }
  }
}

If you already have other MCP servers configured, add this entry to the existing mcpServers object.

Running from Source

Clone the repository:

git clone https://github.com/Couchbase-Ecosystem/couchbase-guru.git

Then point your MCP client at it:

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/cloned/repo/couchbase-guru/",
        "run",
        "src/mcp_server.py"
      ]
    }
  }
}

path/to/cloned/repo/couchbase-guru/ should be the path to the cloned repository on your machine. Don't forget the trailing slash.

Options

All options are optional and can be set via CLI argument or environment variable:

Check the installed version with:

uvx couchbase-guru --version

Self-hosting the documentation agent

By default the server uses a shared, public documentation agent, so most users need no setup. If you run your own agent backend, point the server at it:

uvx couchbase-guru --agent-base-url https://your-agent.example.com

Rate limiting & privacy

Shortened. The full README is on GitHub.