Redis 官方在 AI 方向连续放出两个开源项目:官方 MCP 服务 mcp-redis,让 AI 直接读写 Redis;官方技能包 agent-skills,把 Redis 团队沉淀的最佳实践打包成 AI 可加载的指令。两者配合 Claude Code 使用,用自然语言就能操作数据库。
两个项目分别解决什么
MCP(Model Context Protocol)是让 AI 访问外部数据和工具的标准协议。mcp-redis 是 Redis 官方推出的 MCP 服务实现,相当于给 AI 一套现成的 Redis 操作工具,装上之后可以用自然语言直接操作 Redis,比如“缓存这个数据,1 小时后过期”“数据库里现在有多少个 key”。
工具覆盖面很广:String、Hash、List、Set、Sorted Set、Stream、Pub/Sub、JSON 这些常用数据类型都有对应工具,还支持向量索引和向量搜索,另外提供查询服务器状态、搜索官方文档的能力。在 Claude Code 里执行 /mcp,可以看到它一共提供了 47 个工具。
agent-skills 是 Redis 官方维护的技能合集,把团队最佳实践整理成 8 个技能:
| 技能 | 内容 |
|---|---|
| redis-core | 数据结构选型、key 命名规范、内存与 TTL、JSON vs Hash |
| redis-connections | 连接池、多路复用、pipeline、超时与慢命令 |
| redis-search | 搜索与聚合、向量相似度(HNSW/FLAT)、混合检索、RAG |
| redis-semantic-cache | LangCache 语义缓存、相似度阈值调优 |
| redis-clustering | hash tag、避免 CROSSSLOT、副本读取 |
| redis-security | 认证与 TLS、ACL 最小权限、命令重命名 |
| redis-observability | INFO 指标、SLOWLOG、MEMORY DOCTOR、Redis Insight |
| iris-development | Redis Agent Memory(Iris)的接入 |
两者关系可以这样理解:MCP 相当于 AI 的手,提供读写 Redis 的执行通道,解决“能不能操作”;Skill 不执行任何命令,相当于 AI 的脑,在干活时把官方最佳实践加载进来,解决“操作得专不专业”。
部署:uv 加 cc-switch
第一步装 uv。mcp-redis 是 Python 生态项目,发布在 PyPI 上,官方推荐用 uvx 运行,它是 uv 自带的命令,可以理解为 Python 版的 npx。Windows 下可以直接:
winget install astral-sh.uv
第二步起一个本地 Redis,没有现成实例时用 Docker 最快:
docker run --name redis8 -p 6379:6379 -d redis:8.0
第三步配置 MCP。资料里用的是 cc-switch——一款统一管理 Claude Code、Codex、Gemini CLI 配置的开源工具,可以在图形界面维护 MCP 配置并一键同步到各个 AI 工具,省去手改配置文件。进入 MCP 管理面板添加一项,名称填 redis-mcp,类型选 stdio,JSON 配置如下:
{
"type": "stdio",
"command": "uvx",
"args": [
"--from", "redis-mcp-server@latest",
"--with", "mcp<2",
"redis-mcp-server",
"--url", "redis://192.168.3.101:6379/0"
]
}
--url 按自己的 Redis 地址修改。--with mcp<2 这一行别漏:当前版本的 redis-mcp-server 和刚发布的 SDK 2.0 不兼容,不加会启动报错,等官方适配后可以去掉。勾选启用到 Claude 应用并保存即可。回到 Claude Code 输入 /mcp 查看状态,显示 connected 就说明装好了;首次连接时 uvx 会自动下载依赖,稍等片刻。
Skill 安装
Skill 安装更简单,官方支持通过 Agent Skills CLI 完成,需要本地有 Node.js 环境,一行命令:
npx skills add redis/agent-skills
执行后会列出仓库里的 8 个技能,按提示选择要安装的技能和目标工具(比如 Claude Code)。
三个使用案例
自然语言存查数据。 直接说“帮我把用户张三的信息存到 Redis 里,姓名张三,年龄 28,邮箱 zhangsan@example.com”。Claude Code 会自动调用 MCP 的 json_set 工具,用 user:zhangsan 这样规范的 key 存成 JSON 结构,存完自动调用 json_get 回显确认。再问“张三的邮箱是多少?数据库里现在一共有多少个 key?”,它会调用对应查询工具并把结果整理成自然语言回复,全程不写一行代码。
带过期时间的缓存。 说“把这次会话的摘要缓存到 Redis,key 用 session:demo,1 小时后自动过期”,它会调用 json_set 存入并附带过期参数,之后还能让它用 TTL 确认剩余时间。
让 Skill 指导选型。 问“我要做一个游戏排行榜,实时按分数排名,用 Redis 的什么数据结构合适?帮我把示例数据写进去”。Claude Code 会基于 redis-core 技能回答:排行榜适合用 Sorted Set,它天然按分数排序,支持 ZADD/ZINCRBY 更新分数、ZREVRANGE 取降序 Top N,并按 game:demo:leaderboard 规范命名 key,最后调用 MCP 工具把示例数据真实写入 Redis。
安全与权限
官方资料中与安全直接相关的是 redis-security 技能,它覆盖三类主题:认证与 TLS、ACL 最小权限、命令重命名。也就是说,加载这个技能后,AI 在处理安全相关任务时会按这套实践办事。
以下是工程分析,不属于官方资料:MCP 给 AI 的是一条直连 Redis 的通道,--url 指向哪个库,AI 就能在哪个库上执行工具覆盖范围内的操作。部署时值得把 MCP 指向专用实例或专用库、按最小权限准备连接凭证,而不是直接挂生产主库;同时把 redis-security 技能一并装上,让安全实践在 AI 执行前被加载。
和自建工具调用的差异(工程分析)
自己写一套“让模型调 Redis”的工具并不难,但要自己定义工具 schema、自己封装各类命令、自己维护 key 命名与数据结构选型的约束,模型对 Redis 的理解也不会天然对齐官方实践。mcp-redis 的价值在于 47 个工具开箱即用、覆盖主要数据类型与向量检索;agent-skills 的价值在于把选型、命名、连接、集群、安全、可观测这些经验固化成 AI 可加载的指令。工具管“能做”,技能管“做对”。
Redis 的 AI 布局
| 能力 | 说明 |
|---|---|
| 向量搜索 | 原生支持 HNSW/FLAT 索引,KNN 与范围查询,还有轻量的 Vector Set 类型 |
| LangCache | 语义缓存服务,相似问题直接复用 LLM 响应,降低 API 成本 |
| Agent Memory | 给 AI Agent 提供会话记忆 + 长期记忆,REST API 和 SDK 接入 |
| Context Retriever | 把业务数据封装成 Agent 可靠调用的受管工具 |
| RedisVL | 面向 AI 应用的 Python 向量库 SDK |
| 框架集成 | LangChain、LangGraph、LlamaIndex、Semantic Kernel 等主流框架均有官方集成 |
| Redis Cloud MCP | 用自然语言管理 Redis Cloud 上的订阅和数据库资源 |
项目地址:Redis MCP 为 github.com/redis/mcp-redis,Redis Skill 为 github.com/redis/agent-skills。