Redis MCP Server

Что умеет сервер

Это официальный MCP-сервер Redis, написанный на Python и опубликованный как пакет redis-mcp-server. Он даёт агенту интерфейс на естественном языке к данным в Redis: хранить и читать строки с временем жизни, поля хешей (в хеше можно держать и векторные эмбеддинги), списки, множества, упорядоченные множества, потоки (streams) с группами потребителей, JSON-документы и сообщения pub/sub.

Кроме базовых структур есть инструмент поиска по документации Redis, инструменты Query Engine для управления векторными индексами и векторного поиска и инструмент, который возвращает сведения о самом сервере. README приводит типичные просьбы: сохранить диалог в поток, закешировать элемент, записать сессию со сроком жизни, проиндексировать вектор и найти похожие.

Когда использовать

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

Ограничения и безопасность

Сервер умеет и читать, и менять данные, поэтому для агента заведите отдельного пользователя через Redis ACL. README показывает пример пользователя только для чтения: ACL SETUSER readonlyuser on >mypassword ~* +@read -@write. Логин и пароль затем передаются в аргументах --url, --username, --password или в переменных окружения REDIS_USERNAME и REDIS_PWD.

Поддерживается только транспорт stdio, потоковый HTTP обещан в будущем. Для защищённого соединения используйте схему rediss://, при этом по умолчанию сертификат сервера проверяется, а параметр ssl_cert_reqs=none отключает проверку. Есть режим кластера и вход через EntraID для Azure Managed Redis. Версию Python README указывает 3.14 и выше. Ветка main находится в активной разработке и может ломать совместимость, поэтому при запуске из GitHub авторы советуют брать помеченный релиз.

Claude Desktop

Самый простой путь: uvx. Добавьте в claude_desktop_config.json, указав полный путь к uvx:

{
  "mcpServers": {
    "redis-mcp-server": {
        "type": "stdio",
        "command": "<full_path_to_uvx>",
        "args": [
            "--from", "redis-mcp-server@latest",
            "redis-mcp-server",
            "--url", "redis://localhost:6379/0"
        ]
    }
  }
}

Формат адреса: redis://user:secret@localhost:6379/0, где 0 это номер логической базы. Для зашифрованного соединения (например, с Redis Cloud) используйте схему rediss://.

VS Code с GitHub Copilot

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

{
  "chat.agent.enabled": true
}

Затем добавьте сервер в mcp.json:

"servers": {
  "redis": {
    "type": "stdio",
    "command": "uvx",
    "args": [
      "--from", "redis-mcp-server@latest",
      "redis-mcp-server",
      "--url", "redis://localhost:6379/0"
    ]
  },
}

Чтобы убрать сообщения об установке пакетов в журналах клиента, добавьте -qq первым элементом списка args.

Запуск из командной строки

Установка пакета и запуск:

pip install redis-mcp-server
uvx --from redis-mcp-server@latest redis-mcp-server --url redis://localhost:6379/0

Запуск прямо из GitHub (берите помеченный релиз):

uvx --from git+https://github.com/redis/mcp-redis.git@0.2.0 redis-mcp-server --url redis://localhost:6379/0

Docker

Соберите образ или возьмите готовый mcp/redis:

docker build -t mcp-redis .

Конфигурация клиента (для готового образа замените mcp-redis на mcp/redis):

{
  "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"]
    }
  }
}

Пользователь только для чтения

ACL SETUSER readonlyuser on >mypassword ~* +@read -@write