uptimebolt-mcp-server

UptimeBolt MCP 服务

面向 Claude、Claude Code、Cursor 和任何兼容 MCP 的客户端的 AI 基础设施监控工具。

UptimeBolt 是一个 AI 优先的监控平台，可将监控器分组为逻辑业务服务，在级联故障发生前进行预测，并自动识别导致每起事件的部署，包括相关的提交、文件和代码行。

由西班牙马德里的 CLM Cloud Solutions 构建。

为什么选择 UptimeBolt MCP 服务？

用自然语言询问基础设施相关问题。无需浏览控制面板，让 AI 助手直接查询实时监控数据：

• “现在适合部署吗？” — 根据健康评分、活跃事件和预测结果，获取数据驱动的答案
• “上次事件是什么原因导致的？” — 借助 AI 根因分析和部署关联功能进行分析
• “给我一份过去 24 小时的执行摘要” — 可直接用于每日站会或状态报告
• “显示状态降级的监控器” — 即时查看基础设施中经过筛选的监控器

功能

• 10 种监控工具 — 服务状态、事件、预测、根因分析、部署安全检查等
• 双传输方式 — stdio（本地）+ HTTP（远程/CI-CD）
• API 密钥身份验证 — 安全地按请求访问 UptimeBolt 数据
• 随处可用 — Claude Desktop、Claude Code、Cursor、Cline 和任何 MCP 客户端
• 支持 CI/CD — 可在流水线中直接进行部署安全检查

快速开始

全局安装（推荐）

npm install -g @uptimebolt/mcp-server

Claude Desktop（stdio）

将以下内容添加到 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "uptimebolt": {
      "command": "uptimebolt-mcp",
      "env": {
        "UPTIMEBOLT_API_KEY": "your-api-key",
        "UPTIMEBOLT_API_URL": "https://api.uptimebolt.io"
      }
    }
  }
}

也可以不进行全局安装，使用 npx：

{
  "mcpServers": {
    "uptimebolt": {
      "command": "npx",
      "args": ["-y", "--package=@uptimebolt/mcp-server", "uptimebolt-mcp"],
      "env": {
        "UPTIMEBOLT_API_KEY": "your-api-key",
        "UPTIMEBOLT_API_URL": "https://api.uptimebolt.io"
      }
    }
  }
}

Claude Code / Cursor

将以下内容添加到项目的 .mcp.json：

{
  "mcpServers": {
    "uptimebolt": {
      "command": "uptimebolt-mcp",
      "env": {
        "UPTIMEBOLT_API_KEY": "your-api-key",
        "UPTIMEBOLT_API_URL": "https://api.uptimebolt.io"
      }
    }
  }
}

Docker（HTTP）

docker run -p 3100:3100 \
  -e UPTIMEBOLT_API_URL=https://api.uptimebolt.io \
  ghcr.io/clm-cloud-solutions/uptimebolt-mcp-server:latest

然后通过 mcp-remote 连接：

{
  "mcpServers": {
    "uptimebolt": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:3100/mcp", "--header", "x-api-key:your-api-key"]
    }
  }
}

npm（编程方式）

npm install @uptimebolt/mcp-server

import { TOOLS, HANDLERS } from "@uptimebolt/mcp-server";

// TOOLS — MCP tool definitions (10 tools)
// HANDLERS — tool handler functions: (args, context?) => Promise<result>

可用工具

工具	描述
get_service_status	业务服务的健康状态，包含健康评分（0-100）、监控器明细和活跃事件
get_monitors	列出所有监控器及其运行状态、响应时间和正常运行时间百分比
get_monitor_health	特定监控器的详细健康信息，包含响应时间趋势和活跃预测
get_monitor_metrics	响应时间统计数据（平均值、p95、p99）、正常运行时间百分比和错误明细
get_incidents	活跃及已解决的事件，可选包含 AI 根因分析详情
get_predictions	对即将发生的问题进行 AI 预测，包含置信度和预测影响
get_deployments	最近的部署及自动事件关联（GitHub/GitLab）
run_root_cause_analysis	使用多模型分析（Claude、GPT）进行 AI 根因分析，并关联部署
is_safe_to_deploy	根据健康评分、预测结果和活跃事件进行 CI/CD 部署安全检查
get_executive_summary	基础设施健康摘要，可用于每日站会、周报或状态更新

身份验证

在 app.uptimebolt.io/settings/api-keys 获取 API 密钥。

• stdio 模式：设置 UPTIMEBOLT_API_KEY 环境变量
• HTTP 模式：在每个请求中传递 x-api-key 标头（无需启动密钥）

CI/CD 集成

在部署流水线中将 is_safe_to_deploy 用作关卡：

curl -X POST http://localhost:3100/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "x-api-key: your-api-key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "is_safe_to_deploy",
      "arguments": { "service_name": "my-service" }
    }
  }'

响应包含风险级别（low、medium、high）、活跃问题以及建议（proceed、proceed_with_caution、wait_and_monitor）。

配置

变量	描述	默认值
UPTIMEBOLT_API_KEY	您的 UptimeBolt API 密钥	（stdio 必需）
UPTIMEBOLT_API_URL	UptimeBolt API 基础 URL	http://localhost:3200
MCP_HTTP_PORT	HTTP 服务端口	3100
NODE_ENV	环境（production 会禁用控制台日志）	development
LOG_LEVEL	日志级别（error、warn、info、debug）	debug（开发环境）/ info（生产环境）

开发

git clone https://github.com/clm-cloud-solutions/uptimebolt-mcp-server.git
cd uptimebolt-mcp-server
cp .env.example .env          # configure your environment
npm install
npm run dev          # stdio mode
npm run dev:http     # HTTP mode
npm run build        # compile TypeScript
npm run typecheck    # type check without emitting

关于 UptimeBolt

UptimeBolt 是一个以 AI 为先的 SaaS 监控平台，面向 DevOps 团队和 SRE。主要功能：

• 级联故障预测 — 依赖关系图，支持假设分析、停机成本估算和主动缓解措施
• 部署关联 + RCA 2.0 — 自动将 GitHub/GitLab 部署与事件关联起来，并识别相关提交和文件
• AI Copilot — 对话式助手，可实时获取基础设施上下文
• 8 种监控类型 — HTTP、TCP、DNS、数据库、电子邮件、合成监控、推送、Ping

关于 CLM Cloud Solutions

CLM Cloud Solutions S.L. 是一家总部位于西班牙马德里的科技公司，为工程团队打造 SaaS 产品，助力其自信、快速、安全地开展工作。

• LinkedIn
• GitHub
• 联系方式：[email protected]

许可证

MIT