Skip to content
MCP server

cob-rag-mcp

MCP server and CLI that plug a self-hosted knowledge base into any agent

Runs locallyStatus and history
Install
Platforms
CLI, self-hosted
Runs
Locally
Version
0.2.0
Listing updated
today

Similar MCP servers

About cob-rag-mcp

cob-rag-mcp is an MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.

This package is purely a client for cob-rag-engine, a self-hosted retrieval layer you run yourself. It does not send data to a hosted service; the URL and key you provide decide which engine and which isolated knowledge base, called a corpus, the agent can reach. A corpus key (ck_) sees one knowledge base and nothing else, while a tenant key (tk_) manages more.

The agent calls search to pull passages with sources and answer with its own model, or ask for a complete cited answer written by the model configured in the engine. search needs no model at all. The same 52 tools also exist as CLI commands, such as search, ingest records, corpora create and usage, with tables by default and JSON for scripts.

Destructive tools are hidden unless COB_RAG_ALLOW_DESTRUCTIVE=true, and COB_RAG_READ_ONLY offers only read tools. It needs Node.js 22 or newer and speaks stdio and streamable HTTP.

Install

Run in a terminal

claude mcp add cob-rag-mcp --env COB_RAG_URL='<COB_RAG_URL>' --env COB_RAG_API_KEY='<COB_RAG_API_KEY>' -- npx -y cob-rag-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cob-rag-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cob-rag-mcp"
      ],
      "env": {
        "COB_RAG_URL": "<COB_RAG_URL>",
        "COB_RAG_API_KEY": "<COB_RAG_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cob-rag-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cob-rag-mcp"
      ],
      "env": {
        "COB_RAG_URL": "<COB_RAG_URL>",
        "COB_RAG_API_KEY": "<COB_RAG_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "cob-rag-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "cob-rag-mcp"
      ],
      "env": {
        "COB_RAG_URL": "<COB_RAG_URL>",
        "COB_RAG_API_KEY": "<COB_RAG_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "cob-rag-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cob-rag-mcp"
      ],
      "env": {
        "COB_RAG_URL": "<COB_RAG_URL>",
        "COB_RAG_API_KEY": "<COB_RAG_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "cob-rag-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cob-rag-mcp"
      ],
      "env": {
        "COB_RAG_URL": "<COB_RAG_URL>",
        "COB_RAG_API_KEY": "<COB_RAG_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • COB_RAG_URLAddress of your cob-rag-engine, for example https://rag.example.comRequired
  • COB_RAG_API_KEYA cob-rag-engine key: a knowledge-base key (ck_) reaches only that knowledge baseRequired
  • COB_RAG_READ_ONLYtrue to offer only the tools that read

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

search
Pull relevant passages with sources from a knowledge base.
ask
Return a cited answer written by the engine's model.

What it does

52 shared tools
Every MCP tool is also a CLI command.
Passage search
Returns passages with sources and scores without needing a model.
Cited answers
The ask tool returns an answer written by the engine's model.
Key-scoped access
Corpus and tenant keys limit what a client can see.
Read-only mode
COB_RAG_READ_ONLY exposes only reading tools.
Destructive tools hidden
Destructive actions need an explicit environment variable.

Good for

  • Answer customer questions from a company's own policies
  • Search internal documents from Claude or Cursor
  • Ingest records into a knowledge base from a script
  • Check engine usage from the shell

Pricing

Pricing unknown

Self-hosted; prices not published

Prices change. Check callobuzz.github.io before you buy.

cob-rag-mcp FAQ

Is there a hosted service?

No. You host the engine yourself, for example with docker compose up.

What must I configure?

COB_RAG_URL and COB_RAG_API_KEY.

Which clients work?

Claude, Cursor, VS Code, n8n and any MCP client.

What Node version is required?

Node.js 22 or newer.

How do I add cob-rag-mcp to Claude Code?

Run this command in your terminal: claude mcp add cob-rag-mcp --env COB_RAG_URL='<COB_RAG_URL>' --env COB_RAG_API_KEY='<COB_RAG_API_KEY>' -- npx -y cob-rag-mcp

What are the best alternatives to cob-rag-mcp?

The closest alternatives to cob-rag-mcp are Codebase Memory, XERJ, headroom, omniget and next-ai-draw-io.

Where this comes from

  • Description: written from the project's README and the project's website.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers