Redis MCP Server 是什么?
Redis MCP Server 是把 Redis 数据类型、键、TTL 和搜索能力接入编码任务的服务器。Codex 可以在指定实例和账号权限内检查缓存状态,也能在明确授权后执行受控写入。
一句话理解通过受控 Redis 连接管理键值、哈希、集合和搜索数据,适合开发与排错。
为什么需要它?
让助手在明确实例和数据库范围内查询 Redis,而不是依赖截断日志猜测缓存状态。
接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。
核心能力
读取与管理常见 Redis 数据类型
把真实信息带回当前任务,减少反复复制和手动核对。
检查键、TTL 与内存相关状态
在明确授权范围内调用工具,并保留执行过程和结果。
结合 Redis Search 执行受控检索
回读来源、状态与限制,方便继续处理和人工验收。
适合谁?怎么用?
- 排查 Redis 缓存和键值状态
- 已经使用 Redis,希望在测试实例检查缓存、数据结构或搜索索引的开发团队。
- 实例、数据库编号、键名和 TTL 与 Redis 客户端一致,敏感值已脱敏。
- 不适合把生产连接串写进命令历史,或直接执行 flush、删除和批量改写。
- Redis 可能保存会话、缓存和业务敏感数据
- 写入与删除会影响真实应用行为
怎么接入?
- 1准备
创建只面向测试库的 Redis 用户并限制 ACL。
- 2授权
运行
uvx --from redis-mcp-server@latest redis-mcp-server --url <Redis URL>检查连接。 - 3连接
在客户端登记同一 stdio 命令,凭证通过环境变量或安全存储传入。
- 4开始使用
列出一个测试键并确认数据库编号、主机和 TLS 状态。
安装命令
添加 Redis MCP Server
codex mcp add redis -- uvx --from redis-mcp-server@latest redis-mcp-server --url "redis://USER:PASSWORD@HOST:6379/0"把连接串换成测试实例的受限账号;命令历史可能保存连接串,生产凭证优先改用安全环境变量。
检查命令
确认 MCP 已经登记
codex mcp list不想自己操作终端时,把下面整段发给 Codex。它会先核对官方说明和前置条件,遇到凭证或占位符会停下来询问。
发给 Codex
自助接入 Redis MCP Server
请帮我在当前电脑上接入并验证 Redis MCP Server。
官方来源:https://github.com/redis/mcp-redis
目标接入命令:codex mcp add redis -- uvx --from redis-mcp-server@latest redis-mcp-server --url "redis://USER:PASSWORD@HOST:6379/0"
请按以下步骤执行:
1. 先阅读官方 README,核对当前推荐接入方式与上述命令。如果官方说明已经变化,先告诉我差异,不要盲目执行旧命令。
2. 检查运行环境、登录状态、Token、项目 ID、允许访问路径等前置条件。不要在输出中显示任何凭证,也不要把凭证写入仓库。
3. 如果命令中有需要替换的占位符,先列出需要我提供的值并停下来,不要自行猜测。
4. 条件满足后执行接入命令,再运行 codex mcp list,确认 Redis MCP Server 已登记,并回报实际服务名、传输方式和检查结果。
5. 用下面这个只读任务验证连接:请用 Redis MCP 读取测试库中以 session: 开头的键名和 TTL,只读,不返回值中的 Token。
6. 不要创建、修改、删除、发送内容,也不要连接生产环境;需要写权限或更高权限时先征求我确认。- 复制完整指令,发给一个有终端和当前项目访问权限的 Codex 任务。
- Codex 会先核对官方来源和本机环境;遇到 Token、项目 ID、路径或其他占位符时,应停下来向你确认。
- 接入后运行
codex mcp list,再用 Redis MCP Server 的只读首测任务回读结果。
第一次调用示例
登记完成后,新开一个任务,先用下面这句做只读验证,把目标、范围和停止条件一次说清楚。
发给 Codex
第一次只读任务
请用 Redis MCP 读取测试库中以 session: 开头的键名和 TTL,只读,不返回值中的 Token。怎样算成功
实例、数据库编号、键名和 TTL 与 Redis 客户端一致,敏感值已脱敏。
- 先读取键类型和 TTL,不直接写入。
- 限定键前缀查询测试数据。
- 需要写入时创建可删除的测试键。
- 回读值和 TTL,并在结束后清理测试键。
权限与安全
凭证与连接方式
本地 stdio;使用测试实例和受限账号,凭证优先放环境变量。
- Redis 可能保存会话、缓存和业务敏感数据
- 写入与删除会影响真实应用行为
- 生产实例必须使用独立账号、ACL、TLS 和审计
