How do I use RAGBrain MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@RAGBrain MCP search for information about the project architecture" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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 │ └─────────────────┘ └─────────────────┘ └─────────────────┘