BetterDB MCP Server

官方

面向 Valkey 与 Redis 的可观测性 MCP 服务

分类: 数据库第 31 / 58
Stars: ★ 1.3k 非常热门
传输方式: stdio（本地进程）
运行环境: Node.js 20+ · Docker
凭据: 可选 API Key
许可证: 其他 / 未声明
最近提交: 2 天前

55FMRS · C

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

最强项 · 文档质量 13/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

10/20

维护活跃度

11/20

文档质量

13/20

安装易用性

12/20

查看各项评分依据

可靠性 9/20: 清单明确声明了 npm stdio 包、版本和启动参数，README 也描述了 MCP 入口及其依赖 BetterDB 监控实例，因此正常路径是合理的。但未提供 MCP 初始化、工具列表握手、关键工具测试或实际 CI 内容；“60 tools”缺少逐工具证据，且自动启动、持久化进程和外部数据库依赖带来未验证的失败边界。按静态校准，证据不足以超过 12 分。
安全与权限 10/20: BETTERDB_TOKEN 被标记为 secret，README 提供离线许可和禁用遥测的说明，显示出一定的凭据与网络边界意识。但 MCP 可访问监控数据、ACL 审计、流量捕获、回放、导出和迁移等高影响能力；未见工具级权限、数据范围、敏感数据处理、危险操作确认或完整出站数据流说明。未发现材料支持红线风险，因此不降至 4 分以下。
维护活跃度 11/20: 仓库未归档，给出了版本 1.4.0、公开维护主体、MIT 许可证说明和 GitHub Actions API 测试徽章，表明项目有维护迹象。可是只提供了星数和开放 issue 数，没有提交频率、依赖更新、漏洞响应渠道、发布流程或实际测试结果；顶层元数据为 NOASSERTION，许可证信息也存在不一致。
文档质量 13/20: README 覆盖 Docker、CLI、数据库版本、存储、环境变量、许可、离线部署、Prometheus、API 和常见运行方式，并提供多种示例。扣分原因是未给出 MCP 工具清单、逐工具参数和返回值、权限模型、限制、错误诊断、主流客户端配置示例及成本说明；MCP 包名/徽章信息也有一定不一致。
安装易用性 12/20: README 给出了 Node.js 要求、npx/global npm 安装、BetterDB 地址和令牌来源，manifest 也列出 stdio 传输、参数和环境变量，具备可执行的基础安装路径。但用户仍需准备并配置监控实例及数据库，缺少 Claude Code、Cursor 或其他主流客户端的完整配置示例，也没有验证握手或跨平台注意事项，因此流程仍有手工和未验证环节。

静态评测 · 未实际运行收录于 2026-08-14

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

需要 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，部分功能虽处于早期访问阶段但仍可能受许可限制

安装接入

准备工作

运行环境：Node.js 20+ · Docker

BETTERDB_TOKEN 可选密钥 MCP 认证 token，在 BetterDB Web UI 的 Settings → MCP Tokens 页面生成

其他可选配置项（2 个）

BETTERDB_URL 可选 BetterDB monitor 实例的 URL，默认本地 Docker/CLI 部署为 http://localhost:3001

BETTERDB_INSTANCE_ID 可选多实例云部署时指定目标实例 ID

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

.mcp.json

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

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

生成并校验客户端配置

验证是否装好

先运行 docker run -d --name betterdb -p 3001:3001 betterdb/monitor:latest，在 BetterDB Settings 页面创建 MCP token，然后在 Claude Code 等客户端中确认 MCP 工具列表出现 BetterDB 的监控工具（README 记录共 60 个工具），或询问"当前的慢日志是什么"来验证连接。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出最近的慢日志查询和命令模式
显示当前实例的客户端连接分析
查询过去一小时的异常事件和诊断结果
展示当前 Valkey 集群的拓扑和 slot 热点分布

使用场景

查询 Valkey 或 Redis 的历史慢日志、命令模式、客户端活动和延迟

捕获、筛选、回放和导出实时 MONITOR 流量

分析热点键、集群槽位、CPU、I/O 线程和 ACL 访问记录

将 BetterDB 监控数据用于 Prometheus、AI 应用追踪和故障排查

支持客户端

Claude Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

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