一句话定位:把 Redis 的数据结构交给 AI,用一句话就能存取、索引和检索。

运维和开发碰 Redis,多数时间花在查命令、拼 key、对 TTL 上。Redis 官方把这件事做成了一个 MCP 服务器:你不需要记 HSET 还是 HMSET,直接说「把这个会话存进去,两小时过期」,它自己去调对应命令。这个服务器是 Redis 官方仓库维护的(redis/mcp-redis),MIT 许可证,支持 hash、list、set、sorted set、stream、JSON 和向量检索,传输方式是 stdio。它不是只给 Claude Desktop 用的——任何支持 MCP 的客户端都能接。

核心能力

一、八类数据结构都有对应工具,不是只包一层 GET/SET
字符串工具带过期时间,适合存配置、会话、缓存响应;hash 工具存字段值对,可以放对象属性、用户资料,也能存向量嵌入;list 工具做队列和最近列表;set 工具管唯一值、做交并集;sorted set 天然适配排行榜与优先级队列;stream 支持建消费组、读、ACK、删除;JSON 工具能按路径读写嵌套文档。做活动排行榜时,用 sorted set 一句话就能“取前 20 名并带分数”,不用手写 ZREVRANGE ... WITHSCORES。

二、pub/sub 与 stream 都支持有状态的订阅句柄
它不只是发一条消息就结束,而是能建持久订阅、读已入队的消息。场景很具体:做一个多 Agent 协作的聊天系统,一个 Agent 发事件,另一个订阅并处理,中间靠 Redis 做总线,这条链路在对话里就能搭起来,不用另写一个消费者进程。

三、向量索引与检索,RAG 场景可以直接跑
query engine 工具负责建向量索引和做相似度搜索。如果你本来就用 Redis Stack 做向量库,现在可以让 AI 直接完成“把这批文档向量化存进去,然后找最像的五条”,省掉在 Python 里拼 FT.CREATE 和 FT.SEARCH 的调试时间。

四、内置文档检索工具,不用切窗口查命令
除了操作数据,还有一个 docs 工具,用自然语言查 Redis 官方文档、教程和最佳实践(背后是一个文档搜索 API,可通过 MCP_DOCS_SEARCH_URL 配置)。在改数据结构时顺手问一句“stream 消费组晚确认会怎样”,比开浏览器查快。

五、访问控制按 Redis ACL 走,不是把密码明文塞环境变量
配置支持命令行参数、环境变量(REDIS_HOST / REDIS_PORT / REDIS_PWD / REDIS_SSL / REDIS_CLUSTER_MODE)和 Redis ACL;对 Azure Managed Redis 还支持 EntraID 认证。生产环境里给 MCP 单独开一个只能访问指定 key 前缀的账号,比直接用管理员密码安全得多。

使用上手

  1. 准备一个 Redis:本地 docker run -p 6379:6379 redis,或直接用云上的实例;做向量检索需要 Redis Stack / 带搜索模块的版本。
  2. 选安装方式:最快是 uvx 直跑 PyPI 包;也可以 pip install redis-mcp-server 后 python -m 方式启动;喜欢容器的用官方镜像 mcp/redis。
  3. 写客户端配置:把下方 JSON 填进客户端的 MCP 配置,把 redis://localhost:6379/0 换成你的地址,带密码用 redis://user:pass@host:port/db。
  4. 先跑只读验证:先让它读一个已有 key、列一下库里的结构,确认连通性和权限都对,再让它写。
  5. 按项目建 ACL 账号:给 MCP 一个只能用 app:* 前缀、只能 READ/WRITE 的账号,别直接挂管理员。

优点与不足

优点:

  • 官方维护,数据结构覆盖面完整,不是简化的玩具版。
  • 支持 stdio,本地或容器内都能跑,配置成本低。
  • 向量检索与 JSON 都覆盖,RAG 与文档型场景不用另找一个服务器。
  • 支持 ACL 与 EntraID,生产可落地。

不足:

  • 目前仅支持 stdio,README 说明 streamable-http 仍在计划中,多客户端共享需要自己套一层。
  • 工具数量多,上下文占用不小,小模型容易选错工具。
  • 能直接写库,误操作风险高,必须靠 ACL 扣权限,不能只靠提示词约束。
  • 需要至少 Python 3.14 环境(uv 方式),旧环境要额外处理。

适合谁

  • 已经在用 Redis 做缓存、会话、队列,想让 Agent 直接接手的后端开发。
  • 用 Redis Stack 做向量库、想让 AI 直接管索引和检索的 RAG 项目。
  • 不适合:没有 Redis、或者只是偶尔看一眼 key 的人——装个 RedisInsight 更快。

下载与访问

许可证与获取

项目说明
许可证MIT,可商用可修改
传输方式stdio(streamable-http 待支持)
安装uvx 直跑 / pip 安装 / Docker 镜像
配置项--url 或 REDIS_HOST / PORT / PWD / SSL / CLUSTER_MODE

本文属于「连接器」分类的 AI 资源专栏,更多评测见分类页。