作者 redis · redis/mcp-redis
用英文和 Redis 交互 — 检查键、管理缓存、调整过期时间，以及调试 pub/sub，无需记住每个 Redis 命令。
Redis 官方 MCP 通过类型化工具暴露完整的 Redis 命令界面：字符串、哈希、列表、集合、有序集、Stream、pub/sub 和键管理。默认支持单个 Redis URL；适配 Redis OSS、Redis Stack、Redis Cloud 和 AWS ElastiCache/MemoryDB。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"redis": {
"command": "uvx",
"args": [
"mcp-redis"
]
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"redis": {
"command": "uvx",
"args": [
"mcp-redis"
]
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"redis": {
"command": "uvx",
"args": [
"mcp-redis"
]
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"redis": {
"command": "uvx",
"args": [
"mcp-redis"
]
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "redis",
"command": "uvx",
"args": [
"mcp-redis"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"redis": {
"command": {
"path": "uvx",
"args": [
"mcp-redis"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add redis -- uvx mcp-redis一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 用户说'我更新了个人信息但还显示旧名字' — 可能是缓存失效问题。
REDIS_URL=redis://:pw@host:6379/0user:profile:42* 的键 — 显示每个键的类型和 TTL。✓ 已复制user:profile:42，GET 出值并显示 TTL。它是否过期或符合预期？✓ 已复制结果： 确认修复的缓存，附带过期的键和原因的记录。
KEYS * 在大型实例上会阻塞服务器 — 始终使用 SCAN（服务器会将 scan 工具转换为非阻塞游标）；不要用 KEYS何时使用： 你怀疑某个客户端突发请求超过速率限制；想看实时计数器和 TTL。
ratelimit:* 的键并按前缀分组。显示每组的计数。✓ 已复制ratelimit:api:*，返回整数值最高的 20 个键。✓ 已复制ratelimit:api:client_abc，DELETE 它使下次调用失败开放 — 并将 client_abc 添加到阻止列表集 abuse:blocked，设置 EXPIRE 86400。✓ 已复制结果： 滥用的实时证据加针对性缓解，全部只需几个 Redis 操作。
何时使用： Redis 达到 85% maxmemory，你需要在它驱逐重要键之前知道是什么填满了它。
session: 中没有 TTL（持久化）的键，将 EXPIRE 设为 86400 秒。计数有多少键得到更新。✓ 已复制结果： 内存释放加上根本原因（会话写入时缺少 EXPIRE）以在应用代码中修复。
何时使用： 消费者组滞后；消息未被确认；吞吐量下降。
jobs，显示 XLEN、消费者组和每组的待处理计数。✓ 已复制workers，列出前 20 个 PEL 条目 (XPENDING) — 显示空闲时间和消费者。✓ 已复制结果： Stream 解除阻塞，每批都有记录的操作（回收 vs 确认）。
何时使用： 某个标志对用户子集的行为不符合预期。
flags:new-checkout。显示每个字段和值。✓ 已复制flags:new-checkout:allowlist 和 flags:new-checkout:blocklist。用户 42 在其中任一个吗？✓ 已复制结果： 标志匹配预期状态，附带经过验证的变更记录。
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| scan | pattern: str, count?: int | 通过模式发现键（始终使用，不要用 KEYS） | free |
| type | key: str | 在对未知键进行任何特定数据类型操作前使用 | free |
| get / set / del | key, value?, ex? | 字符串操作 — 缓存、计数器、锁 | free |
| hgetall / hset / hdel | key, field?, value? | 存储为哈希的结构化记录 | free |
| sadd / smembers / sismember / srem | key, member(s) | 阻止列表、允许列表、成员身份 | free |
| zadd / zrange / zrangebyscore | key, score+member(s) | 排行榜、优先队列 | free |
| xadd / xrange / xread / xpending / xclaim / xack | stream ops | Redis Streams 上的工作队列 | free |
| ttl / expire / persist | key, seconds? | 检查或设置过期时间 | free |
| info / memory_usage | section? / key | 容量和性能检查 | free |
count（默认 10 在规模上很慢；1000 是好的批次）。具有 `~pattern` 和 `+@read` 的 ACL 用户用于只读工作REDIS_URL（包括密码）；优先使用 TLS 和 rediss://FLUSHALL FLUSHDB CONFIG SET SHUTDOWNuser claude on >pass ~* +@read)。NOAUTH 需要身份验证REDIS_URL 中缺少密码。使用 redis://:password@host:6379。
redis-cli -u $REDIS_URL PINGMOVED 1234 other-host:6379 (Redis 集群)普通 MCP 使用独立客户端。指向集群感知代理或使用非集群 Redis 端点。
ERR 未知命令 'JSON.GET'那是 Redis Stack 专有的。要么升级到 Redis Stack / Redis Cloud，要么存储为哈希。
redis-cli MODULE LISTOOM 当已用内存 > 'maxmemory' 时不允许命令Redis 满了。检查 MEMORY STATS，驱逐或扩展实例，并为未来的写入设置 TTL。
redis-cli INFO memory| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| Memcached MCP | 你有纯 KV 缓存需求，无数据结构 | 接口小得多；没有列表/集合/Stream |
| DragonflyDB MCP | Redis 兼容但多线程 | 较新；并非每个模块都能工作 |