alertmanager-mcp-server

Instructions

Implementation Reference

• src/alertmanager_mcp_server/server.py:95-113 (handler)

  The primary handler function for the 'get_silences' tool. It is registered using the @mcp.tool decorator and implements the tool logic by calling the make_request helper to fetch silences from the Alertmanager API, optionally filtered by the provided parameter.
  @mcp.tool(description="Get list of all silences") async def get_silences(filter: Optional[str] = None): """Get list of all silences Parameters ---------- filter Filtering query (e.g. alertname=~'.*CPU.*')"), Returns ------- list: Return a list of Silence objects from Alertmanager instance. """ params = None if filter: params = {"filter": filter} return make_request(method="GET", route="/api/v2/silences", params=params)
• src/alertmanager_mcp_server/server.py:37-67 (helper)

  Shared helper function used by the get_silences tool (and others) to perform HTTP requests to the Alertmanager server, handling authentication and error raising.
  def make_request(method="GET", route="/", **kwargs): """Make HTTP request and return a requests.Response object. Parameters ---------- method : str HTTP method to use for the request. route : str (Default value = "/") This is the url we are making our request to. **kwargs : dict Arbitrary keyword arguments. Returns ------- dict: The response from the Alertmanager API. This is a dictionary containing the response data. """ route = urljoin(config.url, route) auth = ( requests.auth.HTTPBasicAuth(config.username, config.password) if config.username and config.password else None ) response = requests.request( method=method.upper(), url=route, auth=auth, timeout=60, **kwargs ) response.raise_for_status() return response.json()