Сервер Redis MCP

Лицензия: Массачусетский технологический институт Версия Python значок кузнеца

Обзор

Redis MCP Server — это интерфейс на естественном языке , разработанный для агентских приложений для эффективного управления и поиска данных в Redis. Он легко интегрируется с клиентами MCP (Model Content Protocol) , позволяя рабочим процессам на основе ИИ взаимодействовать со структурированными и неструктурированными данными в Redis. Используя этот MCP Server, вы можете задавать такие вопросы, как:

«Сохраните весь разговор в потоке»
«Кэшировать этот элемент»
«Сохранить сеанс с указанием срока действия»
«Индексировать и искать этот вектор»

Related MCP server: MCP Server

Функции

Запросы на естественном языке : позволяет агентам ИИ запрашивать и обновлять Redis, используя естественный язык.
Полная интеграция MCP : работает с любым клиентом MCP, обеспечивая бесперебойную связь.
Полная поддержка Redis : обрабатывает хеши, списки, наборы, отсортированные наборы, потоки и многое другое.
Поиск и фильтрация : поддерживает эффективный поиск и извлечение данных в Redis.
Масштабируемость и легкость : разработан для высокопроизводительных операций с данными.

Инструменты

Этот сервер MCP предоставляет инструменты для управления данными, хранящимися в Redis.

Инструменты для работы string , чтобы задать, получить строки с истечением срока действия. Полезно для хранения простых значений конфигурации, данных сеанса или кэширования ответов.
Инструменты hash для хранения пар поле-значение в одном ключе. Хеш может хранить векторные вложения. Полезно для представления объектов с несколькими атрибутами, профилей пользователей или информации о продукте, где к полям можно обращаться индивидуально.
list инструментов с общими операциями для добавления и извлечения элементов. Полезно для очередей, брокеров сообщений или для поддержания списка последних действий.
set инструментов для добавления, удаления и перечисления членов набора. Полезно для отслеживания уникальных значений, таких как идентификаторы пользователей или теги, а также для выполнения операций с наборами, таких как пересечение.
инструменты sorted set для управления данными, например, для таблиц лидеров, очередей приоритетов или аналитики на основе времени с упорядочением на основе баллов.
Функциональность pub/sub для публикации сообщений в каналах и подписки на их получение. Полезно для уведомлений в реальном времени, приложений чата или распространения обновлений среди нескольких клиентов.
streams инструментов для добавления, чтения и удаления из потоков данных. Полезно для источников событий, каналов активности или регистрации данных датчиков с поддержкой групп потребителей.
Инструменты JSON для хранения, извлечения и обработки документов JSON в Redis. Полезно для сложных вложенных структур данных, баз данных документов или управления конфигурацией с доступом на основе пути.

Дополнительные инструменты.

инструменты query engine для управления векторными индексами и выполнения векторного поиска
инструмент server management для получения информации о базе данных

Установка

Для установки сервера следуйте этим инструкциям.

# Clone the repository git clone https://github.com/redis/mcp-redis.git cd mcp-redis # Install dependencies using uv uv venv source .venv/bin/activate uv sync

Конфигурация

Чтобы настроить этот сервер Redis MCP, рассмотрите следующие переменные среды:

Имя	Описание	Значение по умолчанию
`REDIS_HOST`	Redis IP или имя хоста	`"127.0.0.1"`
`REDIS_PORT`	Redis порт	`6379`
`REDIS_USERNAME`	Имя пользователя базы данных по умолчанию	`"default"`
`REDIS_PWD`	Пароль базы данных по умолчанию	""
`REDIS_SSL`	Включает или отключает SSL/TLS	`False`
`REDIS_CA_PATH`	Сертификат CA для проверки сервера	Никто
`REDIS_SSL_KEYFILE`	Файл закрытого ключа клиента для аутентификации клиента	Никто
`REDIS_SSL_CERTFILE`	Файл сертификата клиента для аутентификации клиента	Никто
`REDIS_CERT_REQS`	Должен ли клиент проверять сертификат сервера	`"required"`
`REDIS_CA_CERTS`	Путь к файлу сертификатов доверенного центра сертификации	Никто
`REDIS_CLUSTER_MODE`	Включить режим кластера Redis	`False`
`MCP_TRANSPORT`	Используйте транспорт `stdio` или `sse`	`stdio`

Транспорты

Этот сервер MCP можно настроить для локальной обработки запросов, запуская его как процесс и взаимодействуя с клиентом MCP через stdin и stdout . Это конфигурация по умолчанию. Транспорт sse также можно настроить, чтобы сервер был доступен по сети. Настройте переменную MCP_TRANSPORT соответствующим образом.

export MCP_TRANSPORT="sse"

Затем запустите сервер.

uv run src/main.py

Протестируйте сервер:

curl -i http://127.0.0.1:8000/sse HTTP/1.1 200 OK

Интегрируйте с вашим любимым инструментом или клиентом. Конфигурация VS Code для GitHub Copilot:

"mcp": { "servers": { "redis-mcp": { "type": "sse", "url": "http://127.0.0.1:8000/sse" }, } },

Интеграция с OpenAI Agents SDK

Интегрируйте этот MCP Server с OpenAI Agents SDK. Прочтите документы , чтобы узнать больше об интеграции SDK с MCP.

Установите Python SDK.

pip install openai-agents

Настройте токен OpenAI:

export OPENAI_API_KEY="<openai_token>"

И запустите приложение .

python3.13 redis_assistant.py

Вы можете устранять неполадки в рабочих процессах своих агентов с помощью панели управления OpenAI .

Интеграция с Claude Desktop

Через Смитери

Если вы хотите протестировать сервер Redis MCP, развернутый Smithery , вы можете настроить Claude Desktop автоматически:

npx -y @smithery/cli install @redis/mcp-redis --client claude

Следуйте подсказке и укажите данные для настройки сервера и подключения к Redis (например, с помощью базы данных Redis Cloud). Процедура создаст правильную конфигурацию в файле конфигурации claude_desktop_config.json .

Ручная настройка

Вы можете настроить Claude Desktop для использования этого MCP-сервера.

Укажите ваши учетные данные Redis и конфигурацию TLS
Получите полный путь к вашей команде uv (например, which uv )
Отредактируйте файл конфигурации claude_desktop_config.json
- на MacOS, в ~/Library/Application\ Support/Claude/

{ "mcpServers": { "redis": { "command": "<full_path_uv_command>", "args": [ "--directory", "<your_mcp_server_directory>", "run", "src/main.py" ], "env": { "REDIS_HOST": "<your_redis_database_hostname>", "REDIS_PORT": "<your_redis_database_port>", "REDIS_PWD": "<your_redis_database_password>", "REDIS_SSL": True|False, "REDIS_CA_PATH": "<your_redis_ca_path>", "REDIS_CLUSTER_MODE": True|False } } } }

Использование с Docker

Вы можете использовать dockerized deployment этого сервера. Вы можете либо создать свой собственный образ, либо использовать официальный образ Redis MCP Docker .

Если вы хотите создать свой собственный образ, Redis MCP Server предоставляет Dockerfile. Создайте образ этого сервера с помощью:

docker build -t mcp-redis .

Наконец, настройте Claude Desktop для создания контейнера при запуске. Отредактируйте claude_desktop_config.json и добавьте:

{ "mcpServers": { "redis": { "command": "docker", "args": ["run", "--rm", "--name", "redis-mcp-server", "-i", "-e", "REDIS_HOST=<redis_hostname>", "-e", "REDIS_PORT=<redis_port>", "-e", "REDIS_USERNAME=<redis_username>", "-e", "REDIS_PWD=<redis_password>", "mcp-redis"] } } }

Чтобы использовать официальный образ Redis MCP Docker , просто замените имя образа ( mcp-redis в примере выше) на mcp/redis .

Поиск неисправностей

Вы можете устранить неполадки, просматривая файл журнала.

tail -f ~/Library/Logs/Claude/mcp-server-redis.log

Интеграция с VS Code

Для использования Redis MCP Server с VS Code вам необходимо:

Включите инструменты режима агента . Добавьте следующее в settings.json :

{ "chat.agent.enabled": true }

Добавьте конфигурацию сервера Redis MCP в ваш mcp.json или settings.json :

// Example .vscode/mcp.json { "servers": { "redis": { "type": "stdio", "command": "<full_path_uv_command>", "args": [ "--directory", "<your_mcp_server_directory>", "run", "src/main.py" ], "env": { "REDIS_HOST": "<your_redis_database_hostname>", "REDIS_PORT": "<your_redis_database_port>", "REDIS_USERNAME": "<your_redis_database_username>", "REDIS_PWD": "<your_redis_database_password>", } } } }

// Example settings.json { "mcp": { "servers": { "redis": { "type": "stdio", "command": "<full_path_uv_command>", "args": [ "--directory", "<your_mcp_server_directory>", "run", "src/main.py" ], "env": { "REDIS_HOST": "<your_redis_database_hostname>", "REDIS_PORT": "<your_redis_database_port>", "REDIS_USERNAME": "<your_redis_database_username>", "REDIS_PWD": "<your_redis_database_password>", } } } } }

Более подробную информацию см. в документации VS Code .

Тестирование

Вы можете использовать MCP Inspector для визуальной отладки этого MCP-сервера.

npx @modelcontextprotocol/inspector uv run src/main.py

Примеры использования

Помощники ИИ : позволяют LLM извлекать, хранить и обрабатывать данные в Redis.
Чат-боты и виртуальные агенты : извлечение данных сеанса, управление очередями и персонализация ответов.
Поиск данных и аналитика : запросы к Redis для получения информации в режиме реального времени и быстрого поиска .
Обработка событий : управление потоками событий с помощью Redis Streams .

Внося вклад

Форк репо
Создать новую ветку ( feature-branch )
Примите ваши изменения
Перейдите в свою ветку и отправьте PR!

Лицензия

Данный проект лицензирован в соответствии с лицензией MIT .

Значки

Контакт

Если у вас есть вопросы или вам нужна поддержка, свяжитесь с нами через GitHub Issues .

Redis MCP Server