Local RAG MCP·radif-ru
Local RAG MCP — локальная база знаний и настройка
Local RAG/MCP Knowledge Base Assistant помогает задавать вопросы локальной базе документов через гибридный поиск, Ollama и инструменты чтения файлов.
Что умеет этот сервер
Local RAG/MCP Knowledge Base Assistant помогает задавать вопросы локальной базе документов через гибридный поиск, Ollama и инструменты чтения файлов.
Это локальное Q&A-приложение с CLI и отдельным FastMCP doc-tools, а не готовый облачный коннектор.
Добавь небольшой проверенный корпус и задай вопрос с известным ответом.
Задача для знакомства
Помоги настроить Local RAG MCP на небольшом локальном тестовом корпусе. Проверь пути и параметры Ollama, затем предложи контрольные вопросы с источниками.
Уточнить результат
Проверь cwd: DOCUMENTS_DIR=./docs и файлы индекса относительны рабочему каталогу. PDF/DOCX ingestion и текстовый read_document могут иметь разные возможности.
Как подключить
Выберите подходящий способПодключить Local RAG MCP MCP
Склонируй проект и настрой src/config.py: DOCUMENTS_DIR, OLLAMA_URL и OLLAMA_MODEL. Из src выполни python main.py build-index, затем python main.py для CLI. Для отдельного MCP проверь src/mcp/server.py и transport установленной версии FastMCP; не выдавай интерактивный main.py за stdio MCP.
Что понадобится
- Python-окружение с зависимостями проекта, Ollama, выбранная локальная LLM и каталог тестовых документов. Embedding/reranker модели при первой настройке нужно скачать.
- 01
Подготовь окружение
Python-окружение с зависимостями проекта, Ollama, выбранная локальная LLM и каталог тестовых документов. Embedding/reranker модели при первой настройке нужно скачать.
- 02
Установи и настрой
Склонируй проект и настрой src/config.py: DOCUMENTS_DIR, OLLAMA_URL и OLLAMA_MODEL. Из src выполни python main.py build-index, затем python main.py для CLI. Для отдельного MCP проверь src/mcp/server.py и transport установленной версии FastMCP; не выдавай интерактивный main.py за stdio MCP.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Первый запрос — пример для чата агента
Помоги настроить Local RAG MCP на небольшом локальном тестовом корпусе. Проверь пути и параметры Ollama, затем предложи контрольные вопросы с источниками.Как проверить
Проверь cwd: DOCUMENTS_DIR=./docs и файлы индекса относительны рабочему каталогу. PDF/DOCX ingestion и текстовый read_document могут иметь разные возможности.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Local RAG MCP
Local RAG/MCP Knowledge Base Assistant помогает задавать вопросы локальной базе документов через гибридный поиск, Ollama и инструменты чтения файлов.
Это локальное Q&A-приложение с CLI и отдельным FastMCP doc-tools, а не готовый облачный коннектор. RAG объединяет BM25, FAISS, RRF и reranker.
Что подготовить перед подключением
Python-окружение с зависимостями проекта, Ollama, выбранная локальная LLM и каталог тестовых документов. Embedding/reranker модели при первой настройке нужно скачать.
Как установить и подключить
Склонируй проект и настрой src/config.py: DOCUMENTS_DIR, OLLAMA_URL и OLLAMA_MODEL. Из src выполни python main.py build-index, затем python main.py для CLI. Для отдельного MCP проверь src/mcp/server.py и transport установленной версии FastMCP; не выдавай интерактивный main.py за stdio MCP.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Добавь небольшой проверенный корпус и задай вопрос с известным ответом. Сверь источники, найденные chunks и полный документ; после изменения корпуса пересобери индекс.
Как проверить результат и решить проблемы
Проверь cwd: DOCUMENTS_DIR=./docs и файлы индекса относительны рабочему каталогу. PDF/DOCX ingestion и текстовый read_document могут иметь разные возможности.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Проект требует настройки Python-зависимостей и путей. Простая prefix-проверка путей в исходном server.py не равна надёжной файловой песочнице; не открывай процесс всему диску и чужим пользователям.
Исходники и документация
Репозиторий: radif-ru/local-rag-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.