Wandering Rag

🚀 漫步的 RAG 工具

漫步的 RAG 工具是一款 CLI 工具，專為個人知識管理打造。它能夠從 Notion、Obsidian、Apple Notes 等平臺獲取數據，存儲到 Qdrant 中，並通過 MCP 服務器對外開放。藉助它，Claude Desktop 可以回答如“我什麼時候收養了我的貓，以及最近一次更換她的貓砂盆是什麼時候？”這類個性化問題。

🚀 快速開始

漫步的 RAG 工具是一款強大的 CLI 工具，能幫助你高效管理個人知識。以下為你詳細介紹其使用步驟。

📦 安裝指南

使用 uv（推薦）

uv pip install -e .

啟動 Qdrant 服務

若你還沒有 Qdrant 服務，可以運行以下命令來啟動一個：

cd qdrant-docker
docker-compose up -d

配置環境變量

複製 .env.example 文件並重命名為 .env，然後指定 Markdown 文件夾（或 Obsidian 的知識庫）。

💻 使用示例

主要子命令

該 CLI 工具提供了多個實用的子命令，以下為你詳細介紹：

Markdown 命令

./wandering-rag md index

Notion 命令（正在開發中）

./wandering-rag notion index

MCP 命令

./wandering-rag mcp run-server

配置用於 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"
            }
        }
    }
}