uilding from source or using Docker. Refer to the installation instructions in the documentation. - Is there a specific Go version required? > Yes, Go version 1.24.3 or higher is required to build from source.27:T16cd,

Prometheus Alertmanager MCP

## Table of Contents - [Table of Contents](#table-of-contents) - [1. Introduction](#1-introduction) - [2. Features](#2-features) - [3. Quickstart](#3-quickstart) - [3.1. Prerequisites](#31-prerequisites) - [3.2. Installing via Smithery](#32-installing-via-smithery) - [3.3. Local Run](#33-local-run) - [3.4. Docker Run](#34-docker-run) - [4. Tools](#4-tools) - [5. Development](#5-development) - [6. License](#6-license) ## 1. Introduction Prometheus Alertmanager MCP is a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server for Prometheus Alertmanager. It enables AI assistants and tools to query and manage Alertmanager resources programmatically and securely. ## 2. Features - [x] Query Alertmanager status, alerts, silences, receivers, and alert groups - [x] Create, update, and delete silences - [x] Create new alerts - [x] Authentication support (Basic auth via environment variables) - [x] Docker containerization support ## 3. Quickstart ### 3.1. Prerequisites - Python 3.12+ - [uv](https://github.com/astral-sh/uv) (for fast dependency management). - Docker (optional, for containerized deployment). - Ensure your Prometheus Alertmanager server is accessible from the environment where you'll run this MCP server. ### 3.2. Installing via Smithery To install Prometheus Alertmanager MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@ntk148v/alertmanager-mcp-server): ```bash npx -y @smithery/cli install @ntk148v/alertmanager-mcp-server --client claude ``` ### 3.3. Local Run - Clone the repository: ```bash # Clone the repository $ git clone https://github.com/ntk148v/alertmanager-mcp-server.git ``` - Configure the environment variables for your Prometheus server, either through a .env file or system environment variables: ```shell # Set environment variables (see .env.sample) ALERTMANAGER_URL=http://your-alertmanager:9093 ALERTMANAGER_USERNAME=your_username # optional ALERTMANAGER_PASSWORD=your_password # optional ``` - Add the server configuration to your client configuration file. For example, for Claude Desktop: ```json { "mcpServers": { "alertmanager": { "command": "uv", "args": [ "--directory", "", "run", "src/alertmanager_mcp_server/server.py" ], "env": { "ALERTMANAGER_URL": "http://your-alertmanager:9093s", "ALERTMANAGER_USERNAME": "your_username", "ALERTMANAGER_PASSWORD": "your_password" } } } } ``` - Or install it using make command: ```shell $ make install ``` - Restart Claude Desktop to load new configuration. - You can now ask Claude to interact with Alertmanager using natual language: - "Show me current alerts" - "Filter alerts related to CPU issues" - "Get details for this alert" - "Create a silence for this alert for the next 2 hours" ![](./images/sample1.jpg) ![](./images/sample2.jpg) ### 3.4. Docker Run - Run it with pre-built image (or you can build it yourself): ```bash $ docker run -e ALERTMANAGER_URL=http://your-alertmanager:9093 \ -e ALERTMANAGER_USERNAME=your_username \ -e ALERTMANAGER_PASSWORD=your_password \ -p 8000:8000 ghcr.io/ntk148v/alertmanager-mcp-server ``` - Running with Docker in Claude Desktop: ```json { "mcpSer

#alertmanager

Prometheus Alertmanager MCP Server

Alertmanager MCP Server

Prometheus Alertmanager MCP