← 返回目录
B

BetterDB MCP Server

官方
面向 Valkey 与 Redis 的可观测性 MCP 服务
GitHub 源仓库 ↗
★ 1.3k Stars 分类 · 数据库 非常热门 源版本 caf1f4e5d95e
55FMRS · C
可靠性
9/20
安全与权限
10/20
维护活跃度
11/20
文档质量
13/20
安装易用性
12/20

资料显示该服务由 BetterDB Inc. 维护,使用 npm 包 @betterdb/mcp 和 stdio 传输。它适合通过 MCP 查询 BetterDB Monitor 的 Valkey/Redis 可观测性数据;来源未提供具体工具名称,因此工具清单留空。

查看 FMRS 评分方法 →

BetterDB MCP Server 将 BetterDB Monitor 的 Valkey 和 Redis 监控能力接入 Claude Code、Cursor 及其他 MCP 客户端。它支持历史分析、慢日志与 COMMANDLOG、MONITOR 捕获、热点键、集群可视化、客户端分析、ACL 审计、Prometheus 指标及迁移相关观测。

工具能力

暂未整理工具清单。

安装接入

使用 stdio 运行 npx @betterdb/mcp。通过 BETTERDB_URL 指向 BetterDB Monitor 实例,并在 BetterDB Settings 页面生成 MCP token 后设置 BETTERDB_TOKEN。多实例云部署时可设置 BETTERDB_INSTANCE_ID。也可使用 --autostart 自动启动本地 Monitor;该模式支持 --port 指定 API 端口,默认 3001,支持 sqlite 或 memory 存储。

claude_desktop_config.json
{"command":"npx","args":["@betterdb/mcp"],"env":{"BETTERDB_URL":"http://localhost:3001","BETTERDB_TOKEN":"your-mcp-token","BETTERDB_INSTANCE_ID":"your-instance-id"}}

选型与风险

适合谁

  • 需要 Valkey 8.x 监控与 COMMANDLOG、CLUSTER SLOT-STATS 的团队
  • 需要 Redis 6+ 兼容监控、历史分析和审计记录的运维人员
  • 已经运行 BetterDB Monitor 并希望通过 MCP 查询数据的用户

不适合谁

  • 只需要通用 Redis 写入或管理操作、而不需要 BetterDB Monitor 的用户
  • 没有可连接的 Valkey 或 Redis 实例的用户
  • 需要基于未提供工具清单来编写特定工具调用的用户

所需权限

  • 需要访问 BetterDB Monitor 实例 URL
  • 需要使用 BetterDB Settings 页面生成的 MCP 身份验证 token
  • Monitor 需要连接目标 Valkey 或 Redis 实例以收集监控数据

风险与副作用

  • MONITOR 捕获会记录实时数据库流量,可能暴露敏感命令或数据
  • 持久化审计、分析和捕获数据需要相应存储后端;memory 存储重启后会丢失数据
  • MCP token 属于敏感凭据,应避免泄露
  • 部分高级功能属于 Pro 或 Enterprise,部分功能虽处于早期访问阶段但仍可能受许可限制

常见排障

  1. 确认 Node.js 至少为 20.0.0
  2. 确认 BETTERDB_URL 指向可访问的 Monitor API
  3. 确认 token 来自 BetterDB Settings 页面,并检查多实例部署时的 BETTERDB_INSTANCE_ID
  4. 确认 Monitor 正在运行且端口与配置一致,默认 API 端口为 3001
  5. 使用 --autostart 时检查端口、存储选项以及本地 Valkey 或 Redis 连接

使用场景

查询 Valkey 或 Redis 的历史慢日志、命令模式、客户端活动和延迟
捕获、筛选、回放和导出实时 MONITOR 流量
分析热点键、集群槽位、CPU、I/O 线程和 ACL 访问记录
将 BetterDB 监控数据用于 Prometheus、AI 应用追踪和故障排查

支持客户端

Claude Code完整支持
Cursor完整支持