Wandering Rag
What is Wandering Rag
Wandering-rag is a command-line interface (CLI) tool designed for personal Retrieval-Augmented Generation (RAG) that retrieves data from various sources like Notion, Obsidian, and Apple Notes, storing it in Qdrant and exposing it as an MCP server.
Use cases
Use cases for wandering-rag include tracking personal events like pet adoption dates, managing notes from different applications, and enhancing productivity by consolidating information retrieval into a single command-line tool.
How to use
To use wandering-rag, install it using the command ‘uv pip install -e .’, run a Qdrant server, and configure your Markdown folders or Obsidian vaults in the .env file. You can then execute various subcommands for Markdown, Notion, and MCP functionalities.
Key features
Key features of wandering-rag include the ability to index and retrieve data from multiple note-taking applications, integration with Qdrant for data storage, and the capability to run as an MCP server for enhanced data access.
Where to use
Wandering-rag can be used in personal knowledge management, research, and any context where users need to retrieve and manage information from different note-taking platforms efficiently.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Wandering Rag
Wandering-rag is a command-line interface (CLI) tool designed for personal Retrieval-Augmented Generation (RAG) that retrieves data from various sources like Notion, Obsidian, and Apple Notes, storing it in Qdrant and exposing it as an MCP server.
Use cases
Use cases for wandering-rag include tracking personal events like pet adoption dates, managing notes from different applications, and enhancing productivity by consolidating information retrieval into a single command-line tool.
How to use
To use wandering-rag, install it using the command ‘uv pip install -e .’, run a Qdrant server, and configure your Markdown folders or Obsidian vaults in the .env file. You can then execute various subcommands for Markdown, Notion, and MCP functionalities.
Key features
Key features of wandering-rag include the ability to index and retrieve data from multiple note-taking applications, integration with Qdrant for data storage, and the capability to run as an MCP server for enhanced data access.
Where to use
Wandering-rag can be used in personal knowledge management, research, and any context where users need to retrieve and manage information from different note-taking platforms efficiently.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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" } } } }
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
