openclaude-LLM-local/docs/rag-mcp-starter

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

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

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