Faultline

Faultline MCP Server

Faultline 为 DevOps/SRE 团队提供基础设施监控和事件管理。本仓库介绍 faultline-mcp——Faultline 的远程 MCP 服务，AI Agent（Claude、Claude Code、Claude Desktop 或任何兼容 MCP 的客户端）可通过它操作 Faultline：检查基础设施运行状况、查看和处理事件、查询当前值班人员，以及运行已批准的运行手册。

本仓库仅包含文档。 服务由 Faultline 托管，地址为 https://mcp.fltln.io/mcp（Streamable HTTP 传输）——无需自行安装或运行。

设置

1. 在 Faultline 中创建 API 密钥：设置 → API 密钥。密钥格式类似 flt_...。
2. 将 MCP 客户端指向 https://mcp.fltln.io/mcp，并通过 X-API-Key: flt_... 或 Authorization: Bearer flt_... 发送密钥。

Claude Code：

claude mcp add --transport http faultline-mcp https://mcp.fltln.io/mcp \
  --header "X-API-Key: flt_..."

使用原始 JSON 配置的客户端（Claude Desktop 等）：

{
  "mcpServers": {
    "faultline": {
      "type": "http",
      "url": "https://mcp.fltln.io/mcp",
      "headers": { "X-API-Key": "flt_..." }
    }
  }
}

工具

工具	功能
list_services	查看监控清单及当前状态（可选状态筛选）
get_service	获取一项服务及其最近 10 次检查记录（用于诊断）
list_incidents	查看未解决的事件（或使用 status: "resolved" 查看历史记录）
get_incident	获取完整的事件记录：时间线、AI 摘要、事后分析
acknowledge_incident	确认事件——停止后续升级
resolve_incident	解决事件并附上可选备注（记录在时间线上）
who_is_on_call	查看各排班表当前的值班人员及值班结束时间
list_anomalies	查看近期基于学习所得基线检测到的延迟异常（观测值与基线、z-score、持续小时数，以及是否自动创建了事件）
diagnose_incident	建议下一步操作（运行运行手册 / 升级处理 / 解决 / 等待），并提供候选运行手册。仅进行分析，不会更改任何内容
run_runbook	针对事件执行选定的运行手册——会修改基础设施（可能重启或扩缩服务）

安全性

• 仅限 API 密钥授权范围。 服务不会存储你的密钥——密钥仅在每次请求期间使用，并直接转发至 Faultline 的 API。
• 修改操作须经批准。 run_runbook 是唯一会更改基础设施的工具。其说明要求调用它的 Agent 仅在 diagnose_incident 建议执行后，并且你明确确认之后，才能使用。
• 租户隔离。 每个请求都限定在拥有该 API 密钥的租户范围内——一个密钥绝不会看到或影响其他租户的数据。

支持

如有疑问或遇到问题，请联系 [email protected] 或访问 Faultline 控制面板。