Wandering Rag

🚀 Wandering RAG Tool

A CLI tool for personal knowledge management. It can fetch data from platforms like Notion, Obsidian, and Apple Notes, store it in Qdrant, and make it accessible via the MCP server. (This enables Claude Desktop to answer questions like "When did I adopt my cat, and when was the last time I changed her litter box?")

🚀 Quick Start

📦 Installation

Use uv (recommended):

uv pip install -e .

If you don't have a Qdrant service, run the following command to start one:

cd qdrant-docker
docker-compose up -d

Copy the .env.example file and rename it to .env, then specify the Markdown folder (or Obsidian knowledge base).

💻 Usage Examples

The CLI provides several subcommands:

Basic Usage

Markdown Command

./wandering-rag md index

Notion Command (Under Development)

./wandering-rag notion index

MCP Command

./wandering-rag mcp run-server

Advanced Usage

Configuration for Claude Desktop

Write the following content to the configuration file:

{
    "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"
            }
        }
    }
}