redis/mcp-redis

The official Redis MCP Server is a natural language interface designed for agentic applications to manage and search data in Redis efficiently

Redis MCP Server – Redis的自然语言桥梁

是什么 – 一个轻量级的Python服务器，允许AI代理使用自然语言（或MCP客户端支持的任何语言）与Redis进行对话。它实现了 Model Content Protocol（MCP）传输，公开了一组“工具”，这些工具直接映射到Redis数据结构（字符串、哈希、列表、集合、有序集合、流、JSON、发布/订阅、向量索引等）。

为何重要 – 现代LLM驱动的代理需要一种无需编写低级Redis命令即可存储、检索和搜索数据的方法。通过将自然语言请求（如 “将对话存入流中” 或 “搜索这个向量”）转换为相应的Redis操作，MCP服务器使开发者能够专注于代理逻辑，而服务器则负责数据库交互、认证和扩展。

核心功能

功能	作用
自然语言查询	代理发送纯文本意图；服务器将其翻译为Redis命令。
完整的Redis数据类型支持	字符串、哈希（含嵌入向量）、列表、集合、有序集合、流、JSON、发布/订阅、向量索引。
MCP集成	可与任何MCP客户端（如Claude Desktop、OpenAI Agents SDK）配合使用。
可扩展且轻量	针对高吞吐、低开销操作设计；可运行在Docker容器中。
Azure Entra ID认证	原生支持Azure托管Redis的OAuth令牌处理（服务主体、托管身份或默认凭证流）。
CLI与环境变量配置	所有连接选项（主机、端口、TLS、ACL、集群模式）均可通过命令行标志或环境变量设置。
可扩展工具集	为每种Redis类型提供内置工具，以及用于文档搜索、向量搜索管理、服务器内省的辅助工具。

快速入门

安装 – pip install redis-mcp-server（或使用Docker镜像 mcp/redis）。
运行 –
```
uv run redis-mcp-server --url redis://localhost:6379/0
```
（将URI替换为您的Redis实例；使用TLS请用 rediss://。）
配置客户端 – 在Claude Desktop、OpenAI Agents SDK等中，添加指向您刚刚启动的命令的MCP服务器条目。客户端现在即可发出自然语言命令，服务器会将其翻译为Redis操作。

典型用例

对话记忆 – 将每次对话存入Redis流，以便后续检索或回放。
会话缓存 – 使用 string 工具缓存LLM响应并设置过期时间。
向量搜索后端 – 从代理直接创建和查询向量索引，实现语义搜索。
实时通知 – 使用 pub/sub 工具发布事件，让代理订阅更新。
企业级Azure部署 – 使用Entra ID认证Azure托管Redis，避免使用静态密码。

安装选项

方法	使用方式
PyPI（推荐）	`pip install redis-mcp-server` 后使用 `uv run redis-mcp-server …` 运行
GitHub源码	`uvx --from git+https://github.com/redis/mcp-redis.git redis-mcp-server --url redis://…`
Docker	`docker run --rm -e REDIS_HOST=… -e REDIS_PORT=… mcp/redis`
开发	克隆仓库，`uv venv && uv sync`，然后 `uv run src/main.py`

配置亮点

CLI标志 – --url, --host, --port, --ssl, --cluster-mode 等
环境变量 – REDIS_HOST, REDIS_PORT, REDIS_PWD, REDIS_SSL, REDIS_CLUSTER_MODE，以及Entra ID变量（REDIS_ENTRAID_*）
ACL支持 – 可通过标准Redis ACL命令将服务器限制为只读Redis用户。

生态系统集成

OpenAI Agents SDK – 将服务器作为OpenAI驱动代理的工具提供者使用。
Claude Desktop – 在Claude的 mcpServers JSON块中配置MCP服务器。
VS Code + GitHub Copilot – 本地运行服务器，让Copilot驱动的代理存储/检索数据。
Augment – （在README中列出）一个更高层次的框架，可调用MCP服务器的工具。

获取帮助

Discord: https://discord.gg/redis
GitHub Issues / Discussions
Stack Overflow 标签 mcp-redis
文档 – README本身，以及 https://modelcontextprotocol.io 的MCP规范

许可证

MIT – 免费用于商业和非商业用途。

总结 – Redis MCP Server是一个生产就绪的桥梁，让LLM驱动的代理能够将Redis视为一个可通过自然语言访问的知识存储，全面支持基于Azure的安全认证和Redis的所有原生数据结构。