RedisVL MCP — поиск и запись в индексы Redis
redis-vl-python
MCP-сервер из библиотеки RedisVL дает агенту искать и записывать данные в уже созданные индексы Redis Search
- 433 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- `upsert-records` записывает данные в индексы Redis, пока не включен режим `--read-only`
- Агент получает содержимое индексов целиком, а запуск по HTTP или SSE открывает порт сети
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/redis-vl-pythonОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- `upsert-records` записывает данные в индексы Redis, пока не включен режим `--read-only`
- Агент получает содержимое индексов целиком, а запуск по HTTP или SSE открывает порт сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер входит в RedisVL, клиентскую библиотеку Redis для Python (векторный поиск, кэш, память диалогов). Он подключается к одному или нескольким существующим индексам Redis Search, на старте восстанавливает схему каждого индекса из Redis и отдает MCP-клиентам небольшой фиксированный набор инструментов. Каждый индекс получает логический идентификатор, указанный в YAML-конфиге. Инструмент `list-indexes` перечисляет индексы и их поля для фильтрации, `search-records` ищет записи, а `upsert-records` добавляет или обновляет их, при необходимости считая эмбеддинги векторизатором индекса. Вызывающий задает `query`, `limit`, `offset`, `filter` и `return_fields`. Режим поиска (векторный, полнотекстовый или гибридный) и параметры настройки задаются в конфиге индекса, запрос их не меняет. Запуск идет через `uvx --from redisvl[mcp] rvl mcp --config /path/to/mcp.yaml` по stdio, а флаги `--transport streamable-http` и `--transport sse` включают сетевые режимы. Флаг `--read-only` или `REDISVL_MCP_READ_ONLY=true` убирает инструмент записи. Через `custom_tools` в том же YAML можно описать узкие инструменты с зафиксированным фильтром и набором полей, например `search-support-tickets`.
Для кого. Командам, у которых данные уже лежат в индексах Redis Search и агенту нужен поиск или запись в них через MCP без своего кода запросов.
Подходит, если
- База знаний или тикеты проиндексированы в Redis, и агенту нужен семантический поиск по ним
- Один сервер должен отдавать несколько индексов: агент сначала вызывает `list-indexes`, затем выбирает нужный
- Агент читает одобренный контент, а загрузкой занимается другая система: запуск с `--read-only` скрывает инструмент записи
- Для узкой задачи нужен инструмент вроде `search-support-tickets` с зафиксированным фильтром и полями
- Удаленному клиенту нужен доступ по Streamable HTTP с проверкой JWT
Не подходит, если
- Данные лежат в ключах без индекса Redis Search: сервер читает схему только из существующего индекса и сам его не создает
- Агенту нужны команды Redis для строк, хешей, стримов и JSON: для этого есть отдельный Redis MCP Server
- Тип поиска должен выбираться в каждом вызове: его определяет конфиг индекса, а вызывающий его не меняет
Пример запроса к агенту
Найди в индексе support_tickets пять похожих решенных обращений про сбой оплаты и покажи поля subject и resolutionMCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
Переменные окружения
REDISVL_MCP_READ_ONLY- Значение `true` отключает запись во всех индексах, как флаг `--read-only`.
Ограничения
Индекс Redis Search должен существовать до запуска сервера: он восстанавливает схему из Redis и сам индексы не создает. Адрес Redis и привязки индексов лежат в YAML-конфиге, например `redis_url: redis://localhost:6379`.
Инструмент `upsert-records` включен, пока не задан `--read-only` или `read_only: true` у индекса. HTTP и SSE открывают порт сети; проверку JWT от провайдера идентификации настраивают отдельно, а сопоставление токена с правами в Redis сервер не делает.
Как отключить. Удалите запись `redisvl` из настроек MCP клиента. Удаление сервера данные в Redis не меняет, индексы остаются.
Частые вопросы
Как подключить RedisVL MCP к Claude Code?
Выполните `claude mcp add redisvl -- uvx --from "redisvl[mcp]" rvl mcp --config /path/to/mcp.yaml`. Конфиг должен описывать подключение к Redis и существующие индексы, а запись можно отключить флагом `--read-only`.
Какие инструменты дает сервер?
`list-indexes` для обзора индексов, `search-records` для поиска и `upsert-records` для записи. Последний не регистрируется, если запись отключена для всех индексов.
Можно ли запустить сервер по сети?
Да, флаги `--transport streamable-http --host 0.0.0.0 --port 8000` включают HTTP, а `--transport sse --port 9000` включает SSE. Для HTTP можно потребовать JWT от провайдера идентификации.
Как ограничить сервер только чтением?
Запустите его с `--read-only` или задайте `REDISVL_MCP_READ_ONLY=true`: инструмент `upsert-records` тогда не регистрируется. Для одного индекса действует `read_only: true` в его блоке конфига.
Как с несколькими индексами?
Агент вызывает `list-indexes`, берет логический идентификатор и передает его в аргументе `index` вызовов `search-records` и `upsert-records`. При единственном индексе аргумент можно опустить.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный MCP-сервер Redis: строки, хеши, стримы, JSON и векторный поиск через агента
Локальный MCP-сервер, который превращает папку с документами в базу знаний с гибридным поиском для Claude Code и Cursor
MCP-сервер от проекта OpenSearch открывает агенту кластер: индексы, маппинги, поиск по DSL и состояние шардов.
MCP-сервер дает агенту поиск и ответы по локальным документам с гибридным индексом, повторным ранжированием и ссылками на разделы.
IRedis помогает вводить команды Redis с подсказками, проверяет аргументы и показывает значения ключей в читаемом виде в терминале.
Zvec MCP — векторная база для агента
Zvec MCP Server
17 инструментов MCP дают агенту создавать коллекции Zvec, писать документы и искать по смыслу с индексами HNSW, IVF и FLAT
Коротко о README
В README библиотеки RedisVL раздел про MCP-сервер перечисляет возможности, три команды запуска (stdio, Streamable HTTP, SSE) и флаг `--read-only`, а затем отсылает к документации. Остальной README рассказывает о самой библиотеке: векторный поиск, кэш и память диалогов. Лицензия MIT.