数据库 · Redis 官方仓库

Redis MCP Server

通过受控 Redis 连接管理键值、哈希、集合和搜索数据,适合开发与排错。

CodexClaude Codestdio
已核验查看接入方法 支持 Codex、Claude Code 等平台

Redis MCP Server 是什么?

Redis MCP Server 是把 Redis 数据类型、键、TTL 和搜索能力接入编码任务的服务器。Codex 可以在指定实例和账号权限内检查缓存状态,也能在明确授权后执行受控写入。

一句话理解通过受控 Redis 连接管理键值、哈希、集合和搜索数据,适合开发与排错。

为什么需要它?

让助手在明确实例和数据库范围内查询 Redis,而不是依赖截断日志猜测缓存状态。

接入前,AI 只能依赖你粘贴的材料、截图或旧上下文;接入后,它可以在你授权的范围内调用真实工具,并把结果、来源和状态带回当前任务。

核心能力

01
读取与管理常见 Redis 数据类型

把真实信息带回当前任务,减少反复复制和手动核对。

02
检查键、TTL 与内存相关状态

在明确授权范围内调用工具,并保留执行过程和结果。

03
结合 Redis Search 执行受控检索

回读来源、状态与限制,方便继续处理和人工验收。

适合谁?怎么用?

适合使用
  • 排查 Redis 缓存和键值状态
  • 已经使用 Redis,希望在测试实例检查缓存、数据结构或搜索索引的开发团队。
  • 实例、数据库编号、键名和 TTL 与 Redis 客户端一致,敏感值已脱敏。
不适合
  • 不适合把生产连接串写进命令历史,或直接执行 flush、删除和批量改写。
  • Redis 可能保存会话、缓存和业务敏感数据
  • 写入与删除会影响真实应用行为

怎么接入?

  1. 1
    准备

    创建只面向测试库的 Redis 用户并限制 ACL。

  2. 2
    授权

    运行 uvx --from redis-mcp-server@latest redis-mcp-server --url <Redis URL> 检查连接。

  3. 3
    连接

    在客户端登记同一 stdio 命令,凭证通过环境变量或安全存储传入。

  4. 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

接入前准备

  • 可访问的 Redis 测试实例
  • uvx 或 Docker
  • 最小权限账号与 TLS 配置

官方帮助

官方文档与仓库Redis 官方仓库问题反馈在 GitHub Issues 获取帮助

第一次调用示例

登记完成后,新开一个任务,先用下面这句做只读验证,把目标、范围和停止条件一次说清楚。

发给 Codex

第一次只读任务

请用 Redis MCP 读取测试库中以 session: 开头的键名和 TTL,只读,不返回值中的 Token。
怎样算成功

实例、数据库编号、键名和 TTL 与 Redis 客户端一致,敏感值已脱敏。

  1. 先读取键类型和 TTL,不直接写入。
  2. 限定键前缀查询测试数据。
  3. 需要写入时创建可删除的测试键。
  4. 回读值和 TTL,并在结束后清理测试键。

权限与安全

凭证与连接方式

本地 stdio;使用测试实例和受限账号,凭证优先放环境变量。

  • Redis 可能保存会话、缓存和业务敏感数据
  • 写入与删除会影响真实应用行为
  • 生产实例必须使用独立账号、ACL、TLS 和审计

用小贺API和 MCP,把真实工具接进工作流

从一个 MCP、一个只读任务开始,先把连接、权限和结果验证清楚。

多平台支持兼容主流 MCP 客户端接入方法清楚命令与自助指令分开权限边界明确先只读再扩大范围
进入小贺API