简体中文 | English
让 AI 安全高效地操作 Redis。通过 MCP 协议提供18 个精心设计的工具，在仅消耗 ~1,600 tokens（GPT-4 上下文的 1.2%）的情况下，覆盖 90% 的 Redis 使用场景。
| 痛点 | 传统方案 | Redis MCP Server |
|---|---|---|
| 上下文占用 | 60+ 工具，~5,000+ tokens | 18 工具，~1,600 tokens ✅ |
| 生产安全 | KEYS 命令阻塞服务器 | SCAN 实现，永不阻塞 ✅ |
| 灵活性 | 新增命令需等待更新 | execute 万能工具，即查即用 ✅ |
| 高可用 | 仅支持单机 | Cluster/Sentinel/SSL 全支持 ✅ |
npm install && npm run build# .env
REDIS_HOST=localhost
REDIS_PORT=6379npm start| 类型 | 工具 | 用途 |
|---|---|---|
| 字符串 | get / set / del |
缓存、Session |
| 哈希 | hgetall / hmset |
用户信息、配置存储 |
| 列表 | lrange / lpush / lpop |
消息队列、任务队列 |
| 集合 | smembers / sadd |
标签、去重 |
| 有序集合 | zrange / zadd |
排行榜、延时队列 |
| 工具 | 亮点 |
|---|---|
keys |
SCAN 实现，大数据量不阻塞 |
expire / ttl |
过期时间管理 |
execute |
万能工具，执行任意 Redis 命令 |
batch_execute |
Pipeline 批量，性能提升 10x+ |
info / select |
服务管理 |
// 缓存（带过期时间）
set({ key: "session:123", value: "user_data", ex: 3600 })
// 用户信息存储
hmset({ key: "user:1", fields: { name: "张三", age: "25" } })
hgetall({ key: "user:1" })
// 任务队列
lpush({ key: "queue:tasks", values: ["task1", "task2"] })
lpop({ key: "queue:tasks" })
// 排行榜
zadd({ key: "rank:daily", members: [{ member: "user1", score: 100 }] })
zrange({ key: "rank:daily", start: 0, stop: 9, withscores: true })当 18 个工具不够用时，使用 execute 执行任意命令：
// 原子递增
execute({ command: "hincrby", args: ["user:1", "views", 1] })
// 按分数范围查询
execute({ command: "zrangebyscore", args: ["rank", 100, 200] })
// 事务操作
execute({ command: "multi" })
execute({ command: "incr", args: ["counter"] })
execute({ command: "exec" })// 一次往返执行多个命令，性能提升 10x+
batch_execute({
commands: [
{ command: "get", args: ["key1"] },
{ command: "hgetall", args: ["hash1"] },
{ command: "zrange", args: ["rank", 0, 9] }
]
})// 使用 SCAN 实现，大数据量不会阻塞服务器
keys({ pattern: "user:*" })REDIS_READONLY=true禁止写入操作，只允许查询，适合生产数据分析。
REDIS_CLUSTER=true
REDIS_CLUSTER_NODES=node1:6379,node2:6379,node3:6379REDIS_SENTINEL=true
REDIS_SENTINEL_MASTER_NAME=mymaster
REDIS_SENTINEL_NODES=s1:26379,s2:26379,s3:26379REDIS_TLS_CA=/path/to/ca.pem
REDIS_TLS_CERT=/path/to/client-cert.pem
REDIS_TLS_KEY=/path/to/client-key.pem在 .vscode/settings.json 中添加：
{
"mcpServers": {
"redis": {
"command": "npx",
"args": ["-y", "@wenit/redis-mcp-server"],
"env": {
"REDIS_HOST": "localhost",
"REDIS_PORT": "6379",
"REDIS_PASSWORD": "",
"REDIS_DB": "0"
}
}
}
}{
"mcpServers": {
"redis": {
"command": "node",
"args": ["/path/to/redis-mcp-server/dist/index.js"],
"env": {
"REDIS_HOST": "localhost",
"REDIS_PORT": "6379",
"REDIS_PASSWORD": ""
}
}
}
}// 测试连接
ping({})
// 查看服务器信息
info({ section: "server" })
// 查看内存使用
info({ section: "memory" })
// 查看慢查询
execute({ command: "slowlog", args: ["get", 10] })MIT