Wandering RAG
About
A CLI tool for personal RAG that retrieves data from Notion, Obsidian, Apple Notes, etc., stored in Qdrant and exposed as an MCP server.
Details
- Author
- wandermyz
- GitHub stars
- 6
- Downloads
- 333
- Categories
- Knowledge Base
Jump to
- CLI‑based personal RAG system
- Indexes Markdown from folders or Obsidian vaults
- Notion indexing (work in progress)
- Stores indexed data in Qdrant vector database
- Exposes a Model Context Protocol (MCP) server
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Wandering RAGCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install with uv pip install -e ., run a Qdrant server using the provided Docker Compose file, copy .env.example to .env, and specify your Markdown folders or Obsidian vaults. Use the CLI subcommands: wandering-rag md index for Markdown, wandering-rag notion index (work in progress), and wandering-rag mcp run-server to start the MCP server. Configure Claude Desktop by adding the server to its MCP configuration JSON.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"wandering rag": {
"wandering-rag": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
"."
]
}
}
}
}McpServers
{
"wandering-rag": {
"command": "uv",
"args": [
"pip",
"install",
"-e",
"."
]
}
}Wandering RAG
A CLI tool for personal RAG that retrieves data from Notion, Obsidian, Apple Notes, etc., stored in Qdrant and exposed as an MCP server.
(So that Claude Desktop successfully answers my question "When did I adopt my cat and when did I change her cat litter most recently? ")
Installation
Using uv (recommended):
uv pip install -e .
Run a Qdrant server if you don't have one:
cd qdrant-docker
docker-compose up -d
Copy .env.example as .env and specify the Markdown folders (or Obsidian vaults)
Usage
The CLI provides several subcommands:
Markdown commands
./wandering-rag md index
Notion commands (WIP)
./wandering-rag notion index
MCP commands
./wandering-rag mcp run-server
Configure for Claude Desktop
{
"mcpServers": {
"wandering-rag": {
"command": "<your git checkout path>/wandering-rag/wandering-rag",
"args": ["mcp", "run-server"],
"env": {
"PATH": "<your home folder>/.local/bin:/usr/bin:$PATH"
}
}
}
}
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
