Deprecated

This project has moved to stache-ai - it is no longer maintained here.

RAGBrain MCP

Python 3.10+ License: MIT

MCP server that connects Claude Desktop to your RAGBrain knowledge base.

Install

pip install ragbrain-mcp

Configure Claude Desktop

Add to your config file:

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`

{
  "mcpServers": {
    "ragbrain": {
      "command": "ragbrain-mcp",
      "env": {
        "RAGBRAIN_URL": "http://localhost:8000"
      }
    }
  }
}

Restart Claude Desktop. Done.

Tools

Tool	Description
`ragbrain_list_namespaces`	List namespaces with doc counts
`ragbrain_search`	Semantic search
`ragbrain_browse_namespace`	List docs in a namespace
`ragbrain_get_document`	Get full document by ID
`ragbrain_discover_documents`	Find docs by topic via summary search

Example prompts

"What namespaces do I have?"
"Search for machine learning"
"Show docs in work/projects"
"Get document abc-123"

Config

Environment variables:

Variable	Default	Description
`RAGBRAIN_URL`	`http://localhost:8000`	RAGBrain API URL
`RAGBRAIN_TIMEOUT`	`60`	Request timeout (seconds)
`RAGBRAIN_LOG_LEVEL`	`INFO`	DEBUG, INFO, WARNING, ERROR
`RAGBRAIN_MAX_RESULTS`	`20`	Max search results
`RAGBRAIN_MAX_DOCUMENT_LENGTH`	`100000`	Max doc length (chars)

Development

git clone https://github.com/ragbrain/ragbrain-mcp.git
cd ragbrain-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

┌─────────────────┐     stdio      ┌─────────────────┐     HTTP      ┌─────────────────┐
│  Claude Desktop │ ◄────────────► │  RAGBrain MCP   │ ◄───────────► │  RAGBrain API   │
└─────────────────┘                └─────────────────┘               └─────────────────┘

Troubleshooting

Can't connect? Check RAGBrain is running: curl http://localhost:8000/health

Tools not showing? Verify config path, test with ragbrain-mcp, restart Claude Desktop.

Timeouts? Set RAGBRAIN_TIMEOUT higher.

License

MIT