velocirag — MCP-сервер для Claude Code: что делает и установка
Локальный RAG-сервер для поиска по документам через MCP. Подходит для агентных запросов с векторным, ключевым и графовым поиском.
claude mcp add velocirag -- uvx velociragЧто делает velocirag
velocirag индексирует документы и объединяет четыре слоя поиска: векторное сходство, BM25 по ключевым словам, обход графа знаний и фильтрацию метаданных. Результаты проходят слияние рангов и повторное ранжирование. MCP-сервер даёт агенту инструменты для поиска, индексации, добавления документа, диагностики и просмотра источников.
Внутри используются ONNX Runtime, FAISS, SQLite FTS5 и локальные модели MiniLM и TinyBERT. Индекс можно обновлять постепенно, а граф отслеживает происхождение файлов и затронутые связи. Демон поддерживает прогретые запросы через Unix-сокет. Для запуска нужен CPU и 8GB RAM; API-ключи и GPU не требуются.
Какие задачи решает
- индексировать папку с документами
- искать точные совпадения и связанные понятия
- фильтровать результаты по тегам и статусу
- добавлять отдельные документы в базу
- проверять состояние MCP-сервера
Примеры запросов агенту
- Проиндексируй документы из
./docsи найди материалы о миграции схемы. - Добавь файл
README.mdв базу знаний и проверь состояние сервера. - Найди документы с тегом
pythonи статусомactive, связанные с обработкой ошибок.
Как установить velocirag
Командой платформы
claude mcp add velocirag -- uvx velociraguvx запускает команду с именем пакета; если в README она другая — uvx --from velocirag <команда>
Командой платформы
codex mcp add velocirag -- uvx velociraguvx запускает команду с именем пакета; если в README она другая — uvx --from velocirag <команда>
Файл настроек
{
"mcpServers": {
"velocirag": {
"command": "uvx",
"args": [
"velocirag"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from velocirag <команда>
Файл настроек
{
"servers": {
"velocirag": {
"type": "stdio",
"command": "uvx",
"args": [
"velocirag"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from velocirag <команда>
Командой платформы
gemini mcp add velocirag uvx velociraguvx запускает команду с именем пакета; если в README она другая — uvx --from velocirag <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о velocirag
Как установить velocirag в Claude Code?
Выполните claude mcp add velocirag -- uvx velocirag.
Что делает velocirag?
Сервер индексирует документы и ищет по ним через векторный, ключевой, графовый и метаданный слои. Агент получает инструменты поиска, индексации, добавления документов, диагностики и просмотра источников.
Нужны ли velocirag GPU или API-ключ?
Нет. Поиск работает на CPU через ONNX Runtime; для запуска требуется 8GB RAM.
