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

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

Install Server

A

license - permissive license

-

quality - not tested

F

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

RAGBrain MCP

Deprecated

RAGBrain MCP

Install

Configure Claude Desktop

Tools

Example prompts

Config

Development

Troubleshooting

License

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API