User CLI  →  Agent Orchestrator  →  MCP Client (stdio)
                                          ↓
                               ┌──────────────────────┐
                               │     MCP Server        │
                               │  ┌────────────────┐  │
                               │  │  vector_search  │  │
                               │  │  local_db_query │  │
                               │  └────────────────┘  │
                               └──────────────────────┘
                                    ↓           ↓
                               Qdrant DB    SQLite DB
                               (Docker)   (employees)

git clone <repo-url>
cd local-rag-mcp
cp .env.example .env

docker compose up -d
# Verify: open http://localhost:6333/dashboard

# On Linux/macOS:
bash scripts/pull_models.sh

# On Windows (PowerShell):
ollama pull llama3
ollama pull nomic-embed-text

python -m venv .venv

# Linux/macOS:
source .venv/bin/activate

# Windows:
.venv\Scripts\activate

pip install -r requirements.txt

python scripts/seed_database.py

python main.py
# Inside the REPL:
> /ingest data/documents

python main.py
> What does our documentation say about authentication?
> List all employees in the Engineering department
> How many engineers earn above the department average?

local-rag-mcp/
├── docker-compose.yml       # Qdrant container
├── .env.example             # Config template
├── requirements.txt         # Pinned deps
├── pyproject.toml           # Project metadata & tool config
│
├── config/
│   └── settings.py          # Centralized Pydantic config
│
├── data/
│   ├── documents/           # Drop PDFs/Markdown here
│   └── sqlite/
│       └── employees.db     # Auto-seeded SQLite DB
│
├── scripts/
│   ├── seed_database.py     # Seeds employee DB
│   └── pull_models.sh       # Ollama model helper
│
├── src/
│   ├── ingestion/           # PDF/MD loader, semantic chunker, embedder
│   ├── mcp_server/          # FastMCP server + vector_search + local_db_query tools
│   ├── agent/               # Agent loop + HyDE
│   └── utils/               # Structured logging
│
├── tests/                   # Pytest test suite
└── main.py                  # CLI REPL entry point

pytest tests/ -v