Alertmanager MCP

🚀 喧鬧管理器 MCP 服務器

該項目實現了一個 模型上下文協議 (MCP) 服務器，此服務器與 Prometheus Alertmanager 集成。它在 Claude AI 和 Alertmanager 之間搭建了橋樑，讓 Claude 能夠通過標準化接口對警報進行交互和管理。

✨ 主要特性

1. 警報檢索：從 Alertmanager 獲取並格式化當前警報，還具備可選的過濾功能。
2. 警報詳細信息：當引用特定警報的指紋時，可提供該警報的詳細信息。
3. 靜默管理：提供用於創建、列出和刪除抑制特定警報通知的工具。
4. 警報分組：獲取 Alertmanager 組織的警報組。

🔧 技術細節

• 使用 TypeScript 和 MCP SDK 構建。
• 與 Alertmanager 的 HTTP API (v2) 進行通信。
• 作為基於標準輸入輸出的進程運行，適用於 Claude Desktop。
• 實現了適當的錯誤處理和超時管理。
• 提供強類型的接口來表示警報和靜默數據。

📦 安裝指南

先決條件

• 能夠訪問正在運行的 Prometheus Alertmanager 實例。
• 若使用 Claude Desktop，需要在系統上安裝 Node.js (v18 或更高版本)。

設置

該包可在 npm 上獲取，可直接使用 npx：

npx alertmanager-mcp

也可進行全局安裝：

npm install -g alertmanager-mcp
alertmanager-mcp

💻 使用示例

與 Claude Desktop 結合使用

1. 編輯配置文件，讓 Claude Desktop 使用 MCP 服務器：

{
  "mcpServers": {
    "alertmanager": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--network=host",
        "-e", "ALERTMANAGER_URL=http://your-alertmanager-url:9093",
        "ghcr.io/kaznak/alertmanager-mcp:latest"
      ],
      "env": {}
    }
  }
}

2. 重啟 Claude Desktop 以加載新配置。
3. 現在，您可以讓 Claude 使用自然語言與 Alertmanager 交互：
   • “顯示當前警報”
   • “篩選與 CPU 相關的警報”
   • “獲取此警報的詳細信息”
   • “為接下來的 2 小時為此警報創建靜默”

可用工具

get-alerts

檢索帶有可選過濾功能的警報列表。 參數：

• filter：(可選) 過濾查詢 (例如，alertname=~'.*CPU.*')
• silenced：(可選) 包含靜默警報
• inhibited：(可選) 包含受抑制的警報
• active：(可選) 包含活動警報

get-alert-details

通過警報 ID 獲取詳細信息。 參數：

• alert-id：要獲取詳細信息的警報 ID

create-silence

為特定匹配條件創建靜默。 參數：

• conditions：靜默應匹配的條件
• startsAt：靜默開始的時間（ISO 日期時間）
• endsAt：靜默結束的時間（ISO 日期時間）
• comment：(可選) 靜默的評論

list-silences

列出所有當前靜默。 無參數。

delete-silence

通過靜默 ID 刪除靜默。 參數：

• silence-id：要刪除的靜默 ID