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; сеть нужна для первой загрузки модели; без аутентификации, для одного локального пользователя.

Настройка клиентов

codex
{
    "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

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники