Skip to main content
Glama
deenesjakoruzh

Redis MCP Server

Official
by redis
GitHub
Python
MIT License
269
  • Apple
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Сервер Redis MCP

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

Обзор

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

  1. Укажите ваши учетные данные Redis и конфигурацию TLS

  2. Получите полный путь к вашей команде uv (например, which uv )

  3. Отредактируйте файл конфигурации 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 вам необходимо:

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

{ "chat.agent.enabled": true }

  1. Добавьте конфигурацию сервера 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 .

Внося вклад

  1. Форк репо

  2. Создать новую ветку ( feature-branch )

  3. Примите ваши изменения

  4. Перейдите в свою ветку и отправьте PR!

Лицензия

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

Значки

Контакт

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

Deploy Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

View all tools

Официальный сервер Redis MCP — это интерфейс на естественном языке, разработанный для агентских приложений для эффективного управления и поиска данных в Redis.

  1. Обзор
    1. Функции
      1. Инструменты
        1. Установка
          1. Конфигурация
            1. Транспорты
              1. Интеграция с OpenAI Agents SDK
                1. Интеграция с Claude Desktop
                  1. Через Смитери
                  2. Ручная настройка
                  3. Использование с Docker
                  4. Поиск неисправностей
                2. Интеграция с VS Code
                  1. Тестирование
                    1. Примеры использования
                      1. Внося вклад
                        1. Лицензия
                          1. Значки
                            1. Контакт

                              Related MCP Servers

                              • Redis MCP Server

                                farhankaz
                                A
                                security
                                A
                                license
                                A
                                quality
                                Enables users to perform Redis database operations using the Model Context Protocol (MCP) tools, allowing for efficient data management through commands like setting, getting, and scanning hash fields.
                                Last updated -
                                13
                                51
                                6
                                MIT License

                              • MCP Server

                                la-rebelion
                                -
                                security
                                A
                                license
                                -
                                quality
                                MCP Server simplifies the implementation of the Model Context Protocol by providing a user-friendly API to create custom tools and manage server workflows efficiently.
                                Last updated -
                                3
                                4
                                MIT License

                              • MCP Server

                                agentico-dev
                                -
                                security
                                A
                                license
                                -
                                quality
                                MCP Server provides a simpler API to interact with the Model Context Protocol by allowing users to define custom tools and services to streamline workflows and processes.
                                Last updated -
                                6
                                3
                                MIT License

                              • Redash MCP Server

                                suthio
                                A
                                security
                                F
                                license
                                A
                                quality
                                Model Context Protocol (MCP) server that integrates Redash with AI assistants like Claude, allowing them to query data, manage visualizations, and interact with dashboards through natural language.
                                Last updated -
                                46
                                38
                                • Apple

                              View all related MCP servers

                              Appeared in Searches

                              New MCP Servers

                              MCP directory API

                              We provide all the information about MCP servers via our MCP API.

                              curl -X GET 'https://glama.ai/api/mcp/v1/servers/redis/mcp-redis'

                              If you have feedback or need assistance with the MCP directory API, please join our Discord server