# Deprecated
This project has moved to [stache-ai](https://github.com/stache-ai/stache-ai) - it is no longer maintained here.
# RAGBrain MCP
[](https://www.python.org/downloads/)
[](https://opensource.org/licenses/MIT)
MCP server that connects [Claude Desktop](https://claude.ai/download) to your [RAGBrain](https://github.com/ragbrain/ragbrain) knowledge base.
## Install
```bash
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` |
```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
```bash
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
