Provides read-only MySQL database diagnostics for DBA operations, including lock-wait and blocking-chain analysis, slow-log aggregation, load classification, replication checks, anomaly detection against historical baselines, snapshots, health scoring, root-cause diagnosis, and incident report generation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@mcp-dbwatch Our Postgres is slow and CPU is at 100%, what should I check first?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
DBA 值守与根因报告 · MCP Server
客户还没给你任何数据时，就能出一份带检查清单的事故报告 —— 这是 Tier0 的立身之本。
pip install mcp-dbwatch # 从 PyPI
pip install "./mcp-dbwatch[mysql]" # 从源码（在工具链根目录执行）；要连库就补驱动，或 [postgres]会自动带上它需要的共享库：sqltk-core（只读连库）、sqltk-store（观测/基线/事故）、sqltk-know（阈值/指标字典/18 种故障指纹）。不会带其他 MCP。
Related MCP server: AI-DBA
{
"mcpServers": {
"dbwatch": {
"command": "python",
"args": ["-m", "dbwatch"],
"env": { "DBT_STORE": "~/.dbtoolchain" }
}
}
}按你的客户端（Claude Desktop / Cursor / Cline 等）说明，把这段合并到对应的 mcpServers 配置里。
命令行调试（不挂客户端也能用）：
mcp-dbwatch tools
mcp-dbwatch call <tool> --args '{"sql": "SELECT 1"}'工具 | 作用 |
| 锁等待链：谁阻塞谁。kill 前必须评估回滚耗时 |
| ★ Tier0：贴一段慢日志文本就能聚合 TOP SQL，不需要连库。 |
| 与自身历史基线比对发现异常。没有历史时退化为静态阈值告警，并明确说明 |
| 基于历史趋势做容量预测。样本不足时明确拒绝，不编造趋势 |
| 一次性采集现场信息。这是把 Tier0 升到 Tier1/2 的唯一动作。 |
| 复制状态检查：延迟 / 线程状态 / 错误码 → 修复顺序 |
| 判断当前是 CPU / IO / 锁 / 连接 / 复制 哪类压力。处置方向完全不同，第一步必须分清。 |
| 递归阻塞检测：找出真正的源头（被 kill 的应该是源头，不是中间受害者）。 |
| ★ 根因推理。给 instance_id 用档案，给 snapshot 用快照，什么都没有就用症状文本（Tier0）。 |
| ★ Tier0：只给一句症状描述，就能输出检查清单 + 成因 + 处置。零历史依赖。 |
| 实例健康评分（维度树）+ 违规明细。 |
| 渲染成可交付的事故报告（markdown）。 |
| 列出该引擎支持的逻辑指标（便于客户理解采集了什么）。 |
| ★ Tier0：故障时的标准排查顺序（静态知识，随时可用）。 |
| 把一次观测写入共享档案。这是让 Tier0 → Tier2 升级的唯一写入点。 |
capture_snapshot（或直接粘贴采集文本）→ classify_load 定级 → diagnose 根因 → incident_report 出报告 → 归档为 incident
三层渐进，任何一层都不伪造结论：
tier0：只有症状文本 → 指纹库给出检查清单 + 成因假设 + 处置建议 + 升级标准
tier1：一次只读快照 → 假设收敛，置信度提升
tier2：≥2 次观测跨 ≥7 天 → 才有趋势与容量预测；样本不足显式报 E_NOT_TIER2 并给升级指引
只做「现在怎么了、为什么、怎么处理」。改 SQL 归 mcp-sql-review，改结构归 mcp-change-risk。
python tests/test_dbwatch.py # 不需要 pytest，也不需要数据库MIT © 2026 罗文星 —— 见 LICENSE。
This server cannot be deployed
DBRE-grade SQL analysis inside any MCP client. No connection. No install. Paste a query.
Hosted MCP server for PostgreSQL diagnostics: slow queries, missing indexes, connection pressure.
Read-only, deterministic AI triage and readiness tools implementing Sophon's published rubrics.
IncidentOracle - 12-tool incident management MCP: triage, BaFin DORA reporting, RCA.
