一句话定位:把 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 前缀的账号,比直接用管理员密码安全得多。
使用上手
- 准备一个 Redis:本地
docker run -p 6379:6379 redis,或直接用云上的实例;做向量检索需要 Redis Stack / 带搜索模块的版本。 - 选安装方式:最快是 uvx 直跑 PyPI 包;也可以
pip install redis-mcp-server后python -m方式启动;喜欢容器的用官方镜像mcp/redis。 - 写客户端配置:把下方 JSON 填进客户端的 MCP 配置,把
redis://localhost:6379/0换成你的地址,带密码用redis://user:pass@host:port/db。 - 先跑只读验证:先让它读一个已有 key、列一下库里的结构,确认连通性和权限都对,再让它写。
- 按项目建 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 更快。
下载与访问
- 仓库:https://github.com/redis/mcp-redis
- PyPI 包:
redis-mcp-server - 官方 Docker 镜像:https://hub.docker.com/r/mcp/redis
- 发行版与更新日志:https://github.com/redis/mcp-redis/releases
许可证与获取
| 项目 | 说明 |
|---|---|
| 许可证 | MIT,可商用可修改 |
| 传输方式 | stdio(streamable-http 待支持) |
| 安装 | uvx 直跑 / pip 安装 / Docker 镜像 |
| 配置项 | --url 或 REDIS_HOST / PORT / PWD / SSL / CLUSTER_MODE |
本文属于「连接器」分类的 AI 资源专栏,更多评测见分类页。
评论 0
还没有评论,来说两句吧。