openclaude-LLM-local/docs/rag-mcp-starter/README.md

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

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

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

chmod +x install.sh
./install.sh

Опции:

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

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

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

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

Опции:

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

Healthcheck

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

chmod +x healthcheck.sh
./healthcheck.sh

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

./healthcheck.sh --mode full

Status dashboard

Компактный статус одним запуском:

chmod +x status.sh
./status.sh

С кастомной моделью:

./status.sh --model qwen2.5:3b

Backup

Создание бэкапа конфигов, списка моделей и snapshot Qdrant:

chmod +x backup.sh
./backup.sh

С кастомной папкой:

./backup.sh --output-dir /path/to/backups

С кастомной коллекцией:

./backup.sh --collection mydocs

Restore

Полуавтоматическое восстановление из бэкапа:

chmod +x restore.sh
./restore.sh --from /path/to/backup_YYYYMMDD_HHMMSS

Восстановление snapshot points в Qdrant (best-effort):

./restore.sh --from /path/to/backup_YYYYMMDD_HHMMSS --apply-qdrant

После восстановления:

./healthcheck.sh --mode full

Upgrade (safe workflow)

Безопасное обновление: backup -> update -> healthcheck -> rollback configs при ошибке.

chmod +x upgrade.sh
./upgrade.sh

Опции:

./upgrade.sh --model qwen2.5:3b
./upgrade.sh --skip-model-pull

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

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