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

manifestación

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)

mcp-server-prometheus