# rag-mcp-starter

Минимальный стартовый набор для локального RAG + MCP:

- `docker-compose.yml` - Qdrant
- `index.py` - индексация документов в Qdrant
- `mcp_server.py` - MCP инструменты `search_docs` и `answer_with_citations`
- `requirements.txt` - Python зависимости
- `install.sh` - one-command bootstrap для Ubuntu

## Быстрый запуск

```bash
docker compose up -d
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -r requirements.txt
mkdir -p docs
# Добавьте документы в docs/
python index.py
python mcp_server.py
```

## Автоматический bootstrap

```bash
chmod +x install.sh
./install.sh
```

Опции:

```bash
./install.sh --skip-model-pull
./install.sh --docs-dir /path/to/my/docs
```

## Минимальный bootstrap (без RAG-стека)

Если нужен только OpenClaude + локальная модель (без Docker/Qdrant):

```bash
chmod +x install-minimal.sh
./install-minimal.sh
```

Опции:

```bash
./install-minimal.sh --model qwen2.5:3b
./install-minimal.sh --skip-model-pull
```

## Healthcheck

Проверка готовности стенда:

```bash
chmod +x healthcheck.sh
./healthcheck.sh
```

Полная проверка (включая Qdrant/venv/deps):

```bash
./healthcheck.sh --mode full
```

## Переменные окружения

- `QDRANT_URL` (default `http://127.0.0.1:6333`)
- `QDRANT_COLLECTION` (default `docs`)
- `EMBED_MODEL` (default `nomic-embed-text`)
- `GEN_MODEL` (default `qwen2.5-coder:7b`)
- `RAG_DOCS_DIR` (default `./docs`)
- `CHUNK_SIZE` (default `1000`)
- `CHUNK_OVERLAP` (default `120`)