JinDaGe - wandering-rag MCP Details

article

README

🚀 漫步的 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"
            }
        }
    }
}

wandering-rag