Сервер 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`
`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 .

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

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.

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

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
39
6
TypeScript
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 -
4
3
TypeScript
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 -
13
2
TypeScript
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 -
10
104
21
JavaScript

View all related MCP servers

Redis MCP Server