MCP Redis诊断
用于Redis诊断的MCP服务器——使用AI支持的建议分析内存使用情况、慢日志、客户端连接和密钥空间健康状况。
为什么是这个工具？
大多数Redis MCP服务器都是CRUD包装器（获取/设置密钥）。RedisNexus提供诊断，但针对企业（K8s、多租户SaaS）。这个工具是唯一的 轻量级npm包 用于深度Redis诊断——7个工具，涵盖内存碎片、慢日志模式、客户端连接健康状况、密钥空间分布、延迟分析和配置审计。安装时使用 npx不需要Docker或SaaS。
专业级别
生成可导出的诊断报告（HTML+PDF） 使用Pro许可证密钥。
- 完整的JVM线程转储分析报告，其中包含可操作的建议
- PDF导出以与您的团队共享
- 优先支持
9.00美元/月 — 获取专业版许可证
Pro许可证密钥激活 generate_report MCP-jvm诊断中的MCP工具。
工具（7）
analyze_memory
分析Redis内存使用情况和碎片。
检测：
- 高内存碎片（>1.5倍RSS/使用率）
- 掉期风险（碎片化\<1.0）
- 最大存储压力（接近极限）
- 驱逐模式
- 缺少最大内存配置
- 不安全不胜利政策
analyze_slowlog
分析Redis SLOWLOG的慢速命令。
参数：
count（number，默认值：128）--要检索的慢日志条目数
检测：
- 危险O（N）命令：钥匙、SMEMBERS、HGETALL、SORT
- 高延迟命令（阈值>10ms，>100ms）
- 指挥集中模式
- 慢速日志缓冲区已满（缺少历史记录）
analyze_clients
分析Redis客户端连接。
检测：
- 被阻止的客户端（BLPOP/BRPOP）
- 连接池饱和（最大客户端数>80%）
- 空闲连接（>5分钟）
- 大输出缓冲存储器
- 发布/订阅模式
analyze_keyspace
分析Redis密钥空间分布和缓存有效性。
检测：
- TTL覆盖率低（\<20%的按键）
- 缓存命中率低（\<80%）
- 数据库分布不平衡
- 过期/驱逐率高
- 多数据库反模式
analyze_latency
从latency子系统分析Redis延迟事件。
检测：
- 分叉延迟峰值（RDB/AOF后台保存阻塞操作）
- AOF fsync延迟和写入延迟
- 命令处理速度慢（O（1）个命令出乎意料地慢）
- 驱逐和密钥到期周期延迟
- 主动碎片整理影响
- 随着时间的推移，延迟趋势逐渐增加
> 需要 latency-monitor-threshold 在redis.conf中设置（例如。， CONFIG SET latency-monitor-threshold 100).
analyze_config
分析Redis配置的安全性和可靠性风险。
检测：
- 没有最大内存限制（无限内存增长，OOM风险）
- 不安全的驱逐策略（noeviction导致内存限制错误）
- 网络暴露（绑定0.0.0.0，无保护模式）
- 缺少身份验证（无需密码）
- 禁用持久性（AOF和RDB都关闭——重启时数据丢失）
- 空闲连接累积（超时0）
- 禁用TCP保活（未检测到死连接）
- 服务器频率低（hz\<10减慢后台任务）
analyze_performance
全面的健康评估——运行所有分析器并生成统一的报告。
参数：
slowlog_count（number，默认值：128）--慢日志条目数
安装```bash
npm install -g mcp-redis-diagnostics
或者直接运行：```bash
npx mcp-redis-diagnostics
配置
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
REDIS_URL |
Redis连接字符串 | redis://localhost:6379 |
克劳德桌面版
添加 claude_desktop_config.json:```json
{
"mcpServers": {
"redis-diagnostics": {
"command": "npx",
"args": ["-y", "mcp-redis-diagnostics"],
"env": {
"REDIS_URL": "redis://localhost:6379"
}
}
}
}
### 带密码的Redis：```json
{
"env": {
"REDIS_URL": "redis://:yourpassword@localhost:6379"
}
}
快速演示
配置后，在Claude中尝试以下提示：
- “分析我的Redis内存使用情况——是否存在碎片化？” --显示已用内存与最大内存、碎片率、驱逐策略和内存压力问题
- “检查Redis慢日志中的危险命令” --识别O（N）命令，如KEYS/SMEMBERS、高延迟模式和优化建议
- “运行完整的Redis健康检查” --结合内存、慢日志、客户端、密钥空间和延迟分析的统一报告
> “我的缓存命中率是多少？我的TTL配置正确吗？”
> “给我一个完整的Redis健康检查”
MCP Java后端套件的一部分
此工具是面向后端开发人员的MCP服务器套件的一部分：
- mcp-db分析仪 --PostgreSQL/MySQL/SQLite模式分析
- mcp-jvm诊断 --线程转储和GC日志分析
- mcp迁移顾问 --Flyway/Liquibase迁移风险分析
- mcp弹簧防尘套执行器 --Spring Boot健康状况和指标分析
- mcp-redis诊断 --Redis内存、慢日志和客户端诊断
限制和已知问题
- 单个Redis实例：一次分析一个Redis实例。不支持Redis集群拓扑发现或Sentinel故障转移分析。
- ACL限制：一些工具需要特定的Redis命令（SLOWLOG、CLIENT LIST、LATENCY）。Redis ACL可能会阻止这些。这
analyze_performance统一工具能够优雅地处理部分故障。 - 延迟监控：The
analyze_latency工具需要latency-monitor-threshold在redis.conf中设置。没有它，就不会捕获延迟事件。 - 关键级别分析：键空间分析使用
INFO keyspace骨料。个人钥匙检查（例如，找到最大的钥匙）需要MEMORY USAGE每个密钥，不执行此操作以避免影响生产。 - Redis 集群：没有特定于集群的分析（插槽分布、再平衡、跨节点延迟）。仅适用于单个节点。
- Redis模块：不分析特定于模块的命令和数据类型（RedisJSON、RediSearch、RedithSeries）。
- 内存顾问：内存建议基于
INFO memory统计数据。有关按密钥类型细分的详细内存，请使用redis-cli --bigkeys外部。 - 碎片率：内存碎片使用RSS与已用内存的比率，这可能会被jemalloc扭曲。值\<1.0可能并不总是表示交换。
- 只读：所有命令都是只读的（INFO、SLOWLOG GET、CLIENT LIST、LATENCY）。未修改任何数据或配置。
许可证
麻省理工学院
生命终结：2026-05-10。
此MCP服务器不再维护或分发。公司
已经转向Apify市场参与者。看
irrationalways 关于Apify 和
irrcorp/bzp-poland-tenders 对于当前的公司工作。
npm包尚未发布。存储库已存档
仅供历史参考。
