Skip to content
MCP server

Couchbase Guru

Search the Couchbase documentation from your MCP client via a hosted documentation agent.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.0
Listing updated
4 days ago

About Couchbase Guru

Couchbase Guru is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add couchbase-guru --env CB_AGENT_IP_SALT='<CB_AGENT_IP_SALT>' -- uvx couchbase-guru

Add to claude_desktop_config.json

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uvx",
      "args": [
        "couchbase-guru"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "<CB_AGENT_IP_SALT>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uvx",
      "args": [
        "couchbase-guru"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "<CB_AGENT_IP_SALT>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "couchbase-guru": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "couchbase-guru"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "<CB_AGENT_IP_SALT>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uvx",
      "args": [
        "couchbase-guru"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "<CB_AGENT_IP_SALT>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "couchbase-guru": {
      "command": "uvx",
      "args": [
        "couchbase-guru"
      ],
      "env": {
        "CB_AGENT_IP_SALT": "<CB_AGENT_IP_SALT>"
      }
    }
  }
}

Configuration

  • CB_MCP_TRANSPORTTransport mode for the server (stdio or http). Default is stdio.
  • CB_MCP_HOSTHost to run the MCP server on (default: 127.0.0.1). Used only for HTTP transport mode.
  • CB_MCP_PORTPort to run the MCP server on (default: 8000). Used only for HTTP transport mode.
  • CB_AGENT_BASE_URLBase URL of the documentation agent backend. Set this to run against your own self-hosted agent; if unset, the public agent is used.
  • CB_AGENT_IP_SALTSecret salt used to pseudonymize client IPs (HTTP transport). Set a shared value for consistent hashing across multiple instances; a local salt is generated when unset.
  • CB_MCP_TRANSPORTTransport mode for the server (stdio or http). Default is stdio.
  • CB_MCP_HOSTHost to run the MCP server on (default: 127.0.0.1). Used only for HTTP transport mode.
  • CB_MCP_PORTPort to run the MCP server on (default: 8000). Used only for HTTP transport mode.
  • CB_AGENT_BASE_URLBase URL of the documentation agent backend. Set this to run against your own self-hosted agent; if unset, the public agent is used.
  • CB_AGENT_IP_SALTSecret salt used to pseudonymize client IPs (HTTP transport). Set a shared value for consistent hashing across multiple instances; a local salt is generated when unset.

Pricing

Open source

Couchbase Guru FAQ

Is Couchbase Guru free?

Yes. Couchbase Guru is open source, so you can use and self-host it for free.

How do I add Couchbase Guru to Claude Code?

Run this command in your terminal: claude mcp add couchbase-guru --env CB_AGENT_IP_SALT='<CB_AGENT_IP_SALT>' -- uvx couchbase-guru