Pingera Mcp

by pingera

292 downloads
Not rated
GitHub

About

An MCP server for Pingera monitoring platform. Geo-distributed monitoring, playwright scripts execution, status pages.

Details

Author
pingera
Downloads
292
Categories
Other, Infrastructure

- Modular Pingera API client library with clean abstractions
- Read‑only and read‑write operation modes
- MCP tools for pages, components, checks, alerts, heartbeats, incidents
- Robust error handling with custom exception hierarchy
- Real‑time data via Pingera API v1
- Pydantic models for type‑safe data validation
- Environment‑based configuration management

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Pingera Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the package globally using UV (uv tool install pingera-mcp-server), then configure the Claude Desktop settings with the required PINGERA_API_KEY environment variable. Run the server with python main.py or use the Claude Desktop integration. The server starts in read‑only mode by default; set PINGERA_MODE=read_write to enable write operations.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "pingera mcp": {
            "pingera": {
                "command": "uv",
                "args": [
                    "run",
                    "--with",
                    "pingera-mcp-server",
                    "--python",
                    "3.10",
                    "python",
                    "-m",
                    "pingera_mcp"
                ],
                "env": {
                    "PINGERA_API_KEY": "your_api_key_here",
                    "PINGERA_MODE": "read_only",
                    "PINGERA_BASE_URL": "https://api.pingera.ru/v1",
                    "PINGERA_TIMEOUT": "30",
                    "PINGERA_MAX_RETRIES": "3",
                    "PINGERA_DEBUG": "false",
                    "PINGERA_SERVER_NAME": "Pingera MCP Server"
                }
            }
        }
    }
}

McpServers

{
    "pingera": {
        "command": "uv",
        "args": [
            "run",
            "--with",
            "pingera-mcp-server",
            "--python",
            "3.10",
            "python",
            "-m",
            "pingera_mcp"
        ],
        "env": {
            "PINGERA_API_KEY": "your_api_key_here",
            "PINGERA_MODE": "read_only",
            "PINGERA_BASE_URL": "https://api.pingera.ru/v1",
            "PINGERA_TIMEOUT": "30",
            "PINGERA_MAX_RETRIES": "3",
            "PINGERA_DEBUG": "false",
            "PINGERA_SERVER_NAME": "Pingera MCP Server"
        }
    }
}

Pingera MCP Server

A Model Context Protocol (MCP) server for the Pingera monitoring service, providing seamless integration between AI models and monitoring data.

Features

- Modular Architecture: Separate Pingera API client library with clean abstractions
- Flexible Operation Modes: Run in read-only or read-write mode
- MCP Tools: Execute monitoring operations through tools (list_pages, get_page_details, test_connection)
- Robust Error Handling: Comprehensive error handling with custom exception hierarchy
- Real-time Data: Direct integration with Pingera API v1 for live monitoring data
- Type Safety: Pydantic models for data validation and serialization
- Configurable: Environment-based configuration management

Quick Start

Prerequisites

- Python 3.10+ - UV package manager - Pingera API key

Installation and Setup

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.