mcp-local-rag
mcp-local-rag — MCP-сервер сообщества (автор — shinpr). Локальный RAG-сервер с минимальной настройкой. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- shinpr
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: medium
Читает документы только внутри BASE_DIR/BASE_DIRS; сеть нужна для первой загрузки модели; без аутентификации, для одного локального пользователя.
Настройка клиентов
{
"code": "[mcp_servers.local-rag]\ncommand = \"npx\"\nargs = [\"-y\", \"mcp-local-rag\"]\n\n[mcp_servers.local-rag.env]\nBASE_DIR = \"/absolute/path/to/your/documents\"",
"file": "~/.codex/config.toml",
"lang": "toml",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
MCP Local RAG ищет по личным документам из MCP-клиента или терминала, не отправляя их во внешний API эмбеддингов. Сервер индексирует файлы PDF, DOCX, Markdown и текстовые файлы на вашей машине. Поиск сочетает семантическое сходство с совпадением по ключевым словам, поэтому находит и смысл запроса, и точные технические термины: имена API, классов и коды ошибок. В результатах есть исходные фрагменты и, где возможно, заголовки, номера строк или страниц, чтобы проверить и процитировать оригинал.
API-ключ, Docker, Python и внешняя база данных не нужны. После первой загрузки модели индексация текста и поиск работают офлайн.
Инструменты по README:
sync_startиsync_status— сверка индекса со всеми папками или одним путём и отслеживание задачи;ingest_file— добавить или заменить один файл;ingest_data— добавить текст, Markdown или HTML, который клиент уже получил (сам сервер страницы не скачивает);query_documents— поиск с семантикой и усилением по ключевым словам;read_chunk_neighbors— соседние фрагменты вокруг результата;list_files,delete_file,status— состояние индекса и удаление записей из него.
Кому подойдёт
- Тем, кто работает с закрытой документацией: внутренние спецификации, договоры, заметки, которые нельзя отправлять во внешние сервисы.
- Разработчикам, которым нужно быстро находить в документации точные имена API и коды ошибок.
Похожие серверы — в категории знания и память.
Установка
Нужен Node.js 22.20 или новее и доступ в интернет при первом запуске, чтобы скачать пакет npm и модель эмбеддингов (около 90 МБ). Задайте BASE_DIR — абсолютный путь к папке с документами; она же служит границей безопасности для работы с файлами. DB_PATH и CACHE_DIR тоже лучше указать абсолютными путями, иначе при запуске из разных проектов создадутся отдельные индексы и кеши моделей.
Без MCP-клиента можно пользоваться командной строкой:
npx mcp-local-rag ingest ./docs/
npx mcp-local-rag query "authentication API"Подключение к клиентам
Конфиги приведены дословно из README; замените путь к документам на свой. Подробнее — в инструкции как подключить MCP.
claude mcp add local-rag --scope user --env BASE_DIR=/absolute/path/to/your/documents -- npx -y mcp-local-ragДля OpenCode README приводит отдельный блок для ~/.config/opencode/opencode.json. Несколько папок задаются через BASE_DIRS (JSON-массив), исключения — через IGNORE_PATHS.
Проверка
Перезапустите клиент и попросите синхронизировать все документы в настроенной папке. Первая синхронизация скачивает модель и может занять 1–2 минуты. Затем задайте вопрос по содержимому документов и проверьте, что в ответе есть ссылки на исходные фрагменты.
Примеры задач
Что в документации API сказано об аутентификации? Приведи исходные фрагменты со страницами.Найди описанное поведение ERR_CONNECTION_REFUSED и прочитай соседние фрагменты.Риски
- Чтение файлов. Сервер читает документы только внутри
BASE_DIR,BASE_DIRSили папок из--base-dir; символические ссылки за их пределы отклоняются. - Текст документов — не инструкции. README советует воспринимать найденный текст и подписи к рисункам как исходный материал, а не как команды для агента.
- Сеть. После кеширования моделей обработка и поиск не делают сетевых запросов. Исключение — если в
RAG_RERANK_CMDуказана команда, которая сама обращается к сети. - Без аутентификации. Сервер рассчитан на одного локального пользователя и не разграничивает доступ. Не запускайте несколько процессов записи в один
DB_PATH.
Частые вопросы
Какие форматы поддерживаются?
PDF, DOCX, TXT и Markdown, а также HTML или текст, переданные клиентом через ingest_data. Excel, PowerPoint, отдельные изображения и исходный код не индексируются.
Нужен ли интернет?
Только при первом запуске, чтобы скачать пакет и модель эмбеддингов. Дальше всё работает офлайн.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
Memory
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.