servidor mcp-prometheus

Servidor MCP para interactuar con métricas y datos de Prometheus.

Este es un servidor MCP basado en TypeScript que implementa una interfaz API de Prometheus. Proporciona un puente entre Claude y su servidor Prometheus mediante el Protocolo de Contexto de Modelo (MCP).

Manifestación

Related MCP server: MarineTraffic MCP Server

Características

Recursos

• Listado y acceso al esquema de métricas de Prometheus

• Cada recurso métrico proporciona:

  • Nombre y descripción de la métrica

  • Metadatos detallados de Prometheus

  • Información estadística (conteo, min, max)

• Tipo MIME JSON para acceso a datos estructurados

Capacidades actuales

• Enumere todas las métricas de Prometheus disponibles con descripciones

• Lea información métrica detallada que incluye:

  • Metadatos y texto de ayuda

  • Datos estadísticos actuales (recuento, valores mínimos y máximos)

• Soporte de autenticación básica para instancias seguras de Prometheus

Configuración

El servidor requiere la siguiente variable de entorno:

• PROMETHEUS_URL : La URL base de su instancia de Prometheus

Configuración de autenticación opcional:

• PROMETHEUS_USERNAME : Nombre de usuario para autenticación básica (si es necesario)

• PROMETHEUS_PASSWORD : Contraseña para autenticación básica (si es necesaria)

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Instalación

Para utilizar con Claude Desktop, agregue la configuración del servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json En Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-prometheus": {
      "command": "/path/to/mcp-server-prometheus/build/index.js",
      "env": {
        "PROMETHEUS_URL": "http://your-prometheus-instance:9090"
      }
    }
  }
}

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser complicada. Recomendamos usar el Inspector MCP :

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en su navegador.

Estructura de la API

El servidor expone las métricas de Prometheus a través de la siguiente estructura de URI:

• URI base: http://your-prometheus-instance:9090

• URI de métricas: http://your-prometheus-instance:9090/metrics/{metric_name}

Cada recurso métrico devuelve datos JSON que contienen:

• Nombre de la métrica

• Metadatos (texto de ayuda, tipo)

• Estadísticas actuales (conteo, mínimo, máximo)