trackmcp
Back to directory
wandermyz

wandering-rag

View on GitHub

A CLI tool for personal RAG that retrieves data from Notion, Obsidian, Apple Notes, etc., stored in Qdrant and exposed as an MCP server.

4 stars PythonDeveloper Kits Updated Nov 1, 2025
mcpobsidianrag

Documentation

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):

bash
uv pip install -e .

Run a Qdrant server if you don't have one:

bash
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

bash
./wandering-rag md index

Notion commands (WIP)

bash
./wandering-rag notion index

MCP commands

bash
./wandering-rag mcp run-server

Configure for Claude Desktop

code
{
    "mcpServers": {
        "wandering-rag": {
            "command": "/wandering-rag/wandering-rag",
            "args": ["mcp", "run-server"],
            "env": {
                "PATH": "/.local/bin:/usr/bin:$PATH"
            }
        }
    }
}

Frequently asked questions

What is wandering-rag?

wandering-rag is A CLI tool for personal RAG that retrieves data from Notion, Obsidian, Apple Notes, etc., stored in Qdrant and exposed as an MCP server.

How do I install wandering-rag?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is wandering-rag open source?

Yes — it is hosted on GitHub at https://github.com/wandermyz/wandering-rag and has 4 stars.

Related MCP tools

zhayujiechatgpt-on-wechat

基于大模型搭建的聊天机器人，同时支持 微信公众号、企业微信应用、飞书、钉钉 等接入，可选择ChatGPT/Claude/DeepSeek/文心一言/讯飞星火/通义千问/ Gemini/GLM-4/Kimi/LinkAI，能处理文本、语音和图片，访问操作系统和互联网，支持基于自有知识库进行定制企业智能客服。

39,573 Python
aiai-agentchatgpt+17
Upsonicupsonic

Agent Framework For Fintech for the Model Context Protocol. Enhance AI assistants with powerful integrations. Python-based implementation.

7,670 Python
agentagent-frameworkclaude+7
awslabsmcp

AWS MCP Servers — helping you get the most out of AWS, wherever you use MCP. Python-based implementation. Trusted by 6900+ developers.

6,922 Python
awsmcpmcp-client+6
open-webuimcpo

A simple, secure MCP-to-OpenAPI proxy server Python-based implementation. Trusted by 3500+ developers. Trusted by 3500+ developers.

3,594 Python
mcpmcp-servermcp-to-openapi+2
basicmachines-cobasic-memory

AI conversations that actually remember. Never re-explain your project to Claude again. Local-first, integrates with Obsidian.

1,950 Python
aiclaudeknowledge-management+12
MiniMax-AIminimax-mcp

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

1,032 Python
image-generationimage-to-videomcp+7

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP