
cob-rag-mcp
MCP server and CLI that plug a self-hosted knowledge base into any agent
- 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-mcpAdd 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.comRequiredCOB_RAG_API_KEYA cob-rag-engine key: a knowledge-base key (ck_) reaches only that knowledge baseRequiredCOB_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.



