Deprecated
This project has moved to stache-ai - it is no longer maintained here.
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