Сервер Redis MCP

Обзор

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`

Интеграция с 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

Integrations