mcp-redis

# Redis MCP Server <!-- mcp-name: io.github.redis/mcp-redis --> [](https://github.com/redis/mcp-redis/actions/workflows/ci.yml) [](https://pypi.org/project/redis-mcp-server/) [](https://www.python.org/downloads/) [](./LICENSE.txt) [](https://mseep.ai/app/70102150-efe0-4705-9f7d-87980109a279) [](https://hub.docker.com/r/mcp/redis) [](https://codecov.io/gh/redis/mcp-redis) [](https://discord.gg/redis) [](https://www.twitch.tv/redisinc) [](https://www.youtube.com/redisinc) [](https://twitter.com/redisinc) [](https://stackoverflow.com/questions/tagged/mcp-redis) ## Overview The Redis MCP Server is a **natural language interface** designed for agentic applications to efficiently manage and search data in Redis. It integrates seamlessly with **MCP (Model Content Protocol) clients**, enabling AI-driven workflows to interact with structured and unstructured data in Redis. Using this MCP Server, you can ask questions like: - "Store the entire conversation in a stream" - "Cache this item" - "Store the session with an expiration time" - "Index and search this vector" ## Table of Contents - [Overview](#overview) - [Features](#features) - [Tools](#tools) - [Installation](#installation) - [From PyPI (recommended)](#from-pypi-recommended) - [Testing the PyPI package](#testing-the-pypi-package) - [From GitHub](#from-github) - [Development Installation](#development-installation) - [With Docker](#with-docker) - [Configuration](#configuration) - [Redis ACL](#redis-acl) - [Configuration via command line arguments](#configuration-via-command-line-arguments) - [Configuration via Environment Variables](#configuration-via-environment-variables) - [EntraID Authentication for Azure Managed Redis](#entraid-authentication-for-azure-managed-redis) - [Logging](#logging) - [Integrations](#integrations) - [OpenAI Agents SDK](#openai-agents-sdk) - [Augment](#augment) - [Claude Desktop](#claude-desktop) - [VS Code with GitHub Copilot](#vs-code-with-github-copilot) - [Testing](#testing) - [Example Use Cases](#example-use-cases) - [Contributing](#contributing) - [License](#license) - [Badges](#badges) - [Contact](#contact) ## Features - **Natural Language Queries**: Enables AI agents to query and update Redis using natural language. - **Seamless MCP Integration**: Works with any **MCP client** for smooth communication. - **Full Redis Support**: Handles **hashes, lists, sets, sorted sets, streams**, and more. - **Search & Filtering**: Supports efficient data retrieval and searching in Redis. - **Scalable & Lightweight**: Designed for **high-performance** data operations. - **EntraID Authentication**: Native support for Azure Active Directory authentication with Azure Managed Redis. - The Redis MCP Server supports the `stdio` [transport](https://modelcontextprotocol.io/docs/concepts/transports#standard-input%2Foutput-stdio). Support to the `stremable-http` transport will be added in the future. ## Tools This MCP Server provides tools to manage the data stored in Redis. - `string` tools to set, get strings with expiration. Useful for storing simple configuration values, session data, or caching responses. - `hash` tools to store field-value pairs within a single key. The hash can store vector embeddings. Useful for representing objects with multiple attributes, user profiles, or product information where fields can be accessed individually. - `list` tools with common operations to append and pop items. Useful for queues, message brokers, or maintaining a list of most recent actions. - `set` tools to add, remove and list set members. Useful for tracking unique values like user IDs or tags, and for performing set operations like intersection. - `sorted set` tools to manage data for e.g. leaderboards, priority queues, or time-based analytics with score-based ordering. - `pub/sub` functionality to publish messages to channels and subscribe to receive them. Useful for real-time notifications, chat application