RAGBrain MCP

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