Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@RAGBrain MCPsearch 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
MCP server that connects Claude Desktop to your RAGBrain knowledge base.
Install
pip install ragbrain-mcpConfigure Claude Desktop
Add to your config file:
OS | Path |
macOS |
|
Windows |
|
Linux |
|
{
"mcpServers": {
"ragbrain": {
"command": "ragbrain-mcp",
"env": {
"RAGBRAIN_URL": "http://localhost:8000"
}
}
}
}Restart Claude Desktop. Done.
Tools
Tool | Description |
| List namespaces with doc counts |
| Semantic search |
| List docs in a namespace |
| Get full document by ID |
| 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 API URL |
|
| Request timeout (seconds) |
|
| DEBUG, INFO, WARNING, ERROR |
|
| Max search results |
|
| 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
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.