shinpr/mcp-local-rag

shinpr/mcp-local-rag

от shinpr
MCP сервер для локального семантического поиска с бустом ключевых слов (например, коды ошибок, имена функций). Индексирует PDF, DOCX, TXT, MD без облака, работает offline. Удобен разработчикам: быстрый доступ к технической документации и коду через MCP или CLI. Запуск одной командой npx без Docke...

MCP Local RAG: Search below the surface.

MCP Local RAG

GitHub
stars npm
version License:
MIT MCP
Registry

English | 简体中文 | Deutsch | Español | Português (Brasil) | Français

Search private documents from an MCP client or the terminal without sending them to an embedding API.

mcp-local-rag indexes PDF, DOCX, Markdown, and text files on your machine. Search combines semantic similarity with keyword matching, so queries can match both intent and exact technical terms such as API names, class names, and error codes. Results include source passages and, where available, headings, line numbers, or page numbers so you can check and cite the original document.

No API key, Docker, Python, or external database is required. After the initial model download, text ingestion and search work offline.

Quick Start

Requirements
  • Node.js 22 or later
  • Internet access on first use to download the npm package and embedding model
  • A directory containing the documents you want to search

Set BASE_DIR to that directory. It is also the security boundary for file operations. Replace /absolute/path/to/your/documents below with the directory's absolute path.

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.
0.22.1основная
0.22.0
0.21.3
0.21.2
0.21.1
0.21.0
0.20.1
0.20.0
0.19.1
0.19.0
0.18.6
0.18.5
0.18.4
0.18.3
0.18.2
0.18.1
0.18.0
0.17.4
0.17.3
0.17.2
0.17.1
0.17.0
0.16.1
0.16.0
0.15.4
0.15.3
0.15.2
0.15.1
0.15.0
0.14.2
0.14.1
0.14.0
0.13.2
0.13.1
0.13.0
0.12.0
0.11.1
0.11.0
0.10.1
0.10.0
0.9.0
0.8.2
0.8.1
0.8.0
0.7.0
0.6.0
0.5.6
0.5.5
0.5.4
0.5.3
0.5.2
0.5.1
0.5.0
0.4.2
0.4.1
0.4.0
0.3.0
0.2.3
0.2.2
0.2.1
0.2.0
0.1.5
0.1.4
0.1.3

Выберите клиент, чтобы установить shinpr/mcp-local-rag:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "shinpr-mcp-local-rag-ovpnbntrhw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "/path/to/your/documents"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "shinpr-mcp-local-rag-ovpnbntrhw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "/path/to/your/documents"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "shinpr-mcp-local-rag-ovpnbntrhw": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "/path/to/your/documents"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"shinpr-mcp-local-rag-ovpnbntrhw\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"mcp-local-rag\"],\"env\":{\"BASE_DIR\":\"/path/to/your/documents\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "shinpr-mcp-local-rag-ovpnbntrhw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "/path/to/your/documents"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add shinpr-mcp-local-rag-ovpnbntrhw --env BASE_DIR=/path/to/your/documents -- npx -y mcp-local-rag

Либо через JSON-конфиг:

claude mcp add-json shinpr-mcp-local-rag-ovpnbntrhw "{\"command\":\"npx\",\"args\":[\"-y\",\"mcp-local-rag\"],\"env\":{\"BASE_DIR\":\"/path/to/your/documents\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add shinpr-mcp-local-rag-ovpnbntrhw --env BASE_DIR=/path/to/your/documents -- npx -y mcp-local-rag

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.shinpr-mcp-local-rag-ovpnbntrhw]
command = "npx"
args = ["-y", "mcp-local-rag"]

[mcp_servers.shinpr-mcp-local-rag-ovpnbntrhw.env]
BASE_DIR = "/path/to/your/documents"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите shinpr/mcp-local-rag, а в поле команды запуска — строку ниже:
npx -y mcp-local-rag

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "shinpr-mcp-local-rag-ovpnbntrhw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "/path/to/your/documents"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "shinpr-mcp-local-rag-ovpnbntrhw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "/path/to/your/documents"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например shinpr-mcp-local-rag-ovpnbntrhw.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: shinpr-mcp-local-rag-ovpnbntrhw
    command: npx
    args:
      - "-y"
      - "mcp-local-rag"
    env:
      BASE_DIR: /path/to/your/documents
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "shinpr-mcp-local-rag-ovpnbntrhw": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-local-rag"
      ],
      "env": {
        "BASE_DIR": "/path/to/your/documents"
      }
    }
  }
}

Похожие MCP-сервера

lyonzin/knowledge-rag

lyonzin/knowledge-rag

от lyonzin

Ищет по PDF, markdown, коду и блокнотам офлайн. 1800+ файлов индексирует за 3 минуты, гибридный поиск с реранкингом. Без API-ключей, данные не покидают машину.

Python⭐ 299
needle-ai/needle-mcp

needle-ai/needle-mcp

от needle-ai

MCP сервер для интеграции с Needle — управляйте документами, ищите по коллекциям через Claude Desktop. Поддерживает PDF, DOCX и другие форматы, делая данные доступными для семантического поиска без локальной установки. Идеально для AI-агентов.

Python⭐ 104
ndjordjevic/pinrag

ndjordjevic/pinrag

от ndjordjevic

PinRAG индексирует PDF, GitHub, YouTube, Discord и заметки в единый RAG-индекс. Задавайте вопросы из редактора — ответы с цитатами на источники. Полезен разработчикам и исследователям для работы с ...

Python⭐ 2
vectara/vectara-mcp

vectara/vectara-mcp

официальный

от vectara

MCP-сервер для RAG с Vectara: семантический поиск, генерация и коррекция галлюцинаций. Помогает AI-агентам выдавать фактологически точные ответы с верификацией. Совместим с Claude Desktop.

Python⭐ 29
vezlo/src-to-kb

vezlo/src-to-kb

от vezlo

Преобразует любой репозиторий исходного кода в поисковую базу знаний с автоматической разбивкой, эмбеддингами и интеллектуальным поиском. Поддерживает MCP для интеграции с Claude Code и Cursor, пол...

JavaScript⭐ 40
ragieai/mcp-server

ragieai/mcp-server

официальный

от ragieai

Извлекайте информацию из базы знаний Ragie с помощью MCP-сервера. Инструмент retrieve возвращает релевантные фрагменты, учитывая ранжирование и свежесть. Идеален для интеграции корпоративных знаний...

JavaScript⭐ 91
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин