mcp-local-rag

mcp-local-rag

shinprMIT
295 звёзд54 форков
mcp-local-rag — это локальный RAG-сервер для разработчиков. Он ищет по вашим документам, используя семантический поиск и точное совпадение ключевых слов. Все данные остаются на вашем устройстве: не нужны API-ключи, облачные сервисы или интернет после первой загрузки модели. Сервер подходит для работы с технической документацией, API-спецификациями и кодом. Вы можете подключать его к AI-инструментам через MCP-протокол или использовать как CLI. Интеграция с Cursor, Codex и Claude Code занимает минуту.
Ai-ml
Открыть на GitHub

Установка

npx -y mcp-local-rag

Характеристики

Общее

  • СтатусСообщество
  • Разработчикshinpr
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Загружает документы в RAG-базу: поддерживает PDF, текстовые файлы и другие форматы
  • Ищет по документам семантически — находит смысл запроса, а не просто совпадения слов
  • Усиливает точные совпадения технических терминов: названия функций, классов, коды ошибок получают приоритет
  • Делит документы на осмысленные фрагменты по границам тем, а не по количеству символов
  • Фильтрует результаты по разрывам релевантности — возвращает только действительно подходящие куски
  • Работает полностью в офлайне после первой загрузки модели
  • Устанавливается одной командой npx без Docker, Python или серверов
  • Поддерживает несколько корневых директорий через переменную BASE_DIRS

Как подключить

Установите и настройте сервер за три шага:

  1. Запустите команду установки:

    npx -y mcp-local-rag

  2. Добавьте конфигурацию в файл настроек вашего MCP-клиента. Для Claude Desktop отредактируйте claude_desktop_config.json:

    {
  "mcpServers": {
    "local-rag": {
      "command": "npx",
      "args": ["-y", "mcp-local-rag"],
      "env": {
        "BASE_DIR": "/путь/к/вашим/документам"
      }
    }
  }
}

  3. Перезапустите клиент. Сервер готов к работе.

Примеры запросов

  • «Загрузи файл api-spec.pdf и создай по нему индекс»
  • «Что в документации сказано про аутентификацию?»
  • «Покажи фрагменты, где упоминается useEffect и его параметры»
  • «Найди описание функции calculateDiscount в технической документации»

Технические детали

  • Язык реализации: TypeScript
  • Транспорт: stdio (MCP-протокол)
  • Лицензия: MIT
  • Совместимые клиенты: любые MCP-клиенты (Cursor, Codex, Claude Code, Claude Desktop и другие)
  • Требования: Node.js
  • Хранение данных: локально, на вашем устройстве

Поделиться