mcp-health-monitor

Monitoreo de salud de servidores MCP, seguimiento del tiempo de actividad, estado de las canalizaciones de Azure DevOps y evaluación de alertas mediante herramientas de lenguaje natural.

npm version npm downloads License: MIT Node.js

Qué hace esto

mcp-health-monitor mantiene un registro de los servidores MCP que le interesan, realiza protocolos de enlace MCP reales con ellos, registra el historial de salud en SQLite e informa sobre el tiempo de actividad, la latencia y los umbrales de alerta a través de herramientas MCP. También realiza un seguimiento de las canalizaciones de Azure DevOps para que la salud de la aplicación y la salud de la entrega se puedan verificar desde el mismo lugar.

Inicio rápido

Ejecute el monitor sobre stdio:

npx -y mcp-health-monitor

Ejemplo de entrada MCP para Claude Desktop o VS Code:

{
  "name": "mcp-health-monitor",
  "version": "1.0.2",
  "mcpName": "io.github.oaslananka/mcp-health-monitor",
  "description": "Monitor MCP server health, uptime, response times, and Azure DevOps pipelines",
  "transport": "stdio",
  "command": "npx",
  "args": ["-y", "mcp-health-monitor"]
}

Referencia de herramientas

Herramienta	Propósito	Prompt típico
`register_server`	Guardar un servidor MCP para monitorear	`Register https://example.com/mcp as prod-gateway`
`check_server`	Ejecutar una verificación de salud en vivo para un servidor	`Check prod-gateway now`
`check_all`	Verificar todos los servidores registrados	`Check all my MCP servers`
`get_uptime`	Devolver el tiempo de actividad más estadísticas de latencia	`Show 24h uptime for prod-gateway`
`get_dashboard`	Devolver datos del panel en JSON	`Give me a 24h dashboard`
`get_report`	Devolver un informe en Markdown	`Generate a Markdown health report for 24h`
`list_servers`	Mostrar servidores registrados	`List all monitored servers`
`unregister_server`	Eliminar un servidor	`Stop monitoring local-debugger`
`set_alert`	Configurar umbrales	`Alert if prod-gateway exceeds 500ms or drops below 99% uptime`
`get_monitor_stats`	Mostrar estadísticas a nivel de monitor	`How many checks has the monitor recorded?`
`register_azure_pipelines`	Registrar grupos de canalizaciones de Azure	`Track CI and Publish pipelines for my repo`
`check_pipeline_status`	Leer las últimas ejecuciones de canalizaciones de Azure	`Check pipeline status for my release group`
`get_pipeline_logs`	Obtener registros de compilación de Azure	`Show the failed logs for the latest Publish build`
`check_all_projects`	Combinar la salud de MCP y Azure	`Check all projects`

Integración con Azure DevOps

Registre un grupo de canalizaciones con una organización, proyecto, nombres de canalización y un PAT:

register_azure_pipelines name="mcp-health-monitor" organization="oaslananka" project="open-source" pipeline_names=["mcp-health-monitor CI","mcp-health-monitor Publish"] pat_token="..."

Los tokens PAT se almacenan como base64 en la base de datos SQLite local para la v1.0. Esto es codificación, no cifrado. Consulte las notas de almacenamiento de credenciales.

Configuración de alertas

Use set_alert para configurar un servidor:

Campo	Significado
`max_response_time_ms`	Alertar cuando una verificación supera esta latencia
`min_uptime_percent`	Alertar cuando la ventana de tiempo de actividad seleccionada cae por debajo de este valor
`consecutive_failures_before_alert`	Alertar después de esta cantidad de resultados no positivos consecutivos

Las alertas son evaluadas en línea por check_server, check_all y get_dashboard. La entrega mediante webhooks está planificada para la v1.1, y no se incluye ninguna herramienta MCP de webhook en la v1.0.x.

Almacenamiento de datos

Ruta de base de datos predeterminada: ~/.mcp-health-monitor/health.db
Ruta de anulación: HEALTH_MONITOR_DB=/custom/path/health.db
Programador en segundo plano opcional: HEALTH_MONITOR_AUTO_CHECK=1
Punto final de salud del servidor HTTP: GET /health
Configuración de ejemplo: .env.example

La base de datos utiliza el modo WAL en bases de datos respaldadas por archivos y aplica migraciones de esquema automáticamente al inicio.

Docker

Construir y ejecutar:

docker build -t mcp-health-monitor .
docker run --rm -p 3000:3000 -e HEALTH_MONITOR_AUTO_CHECK=1 mcp-health-monitor

Luego verifique:

curl http://localhost:3000/health

Desarrollo

npm install
npm run build
npm test
npm run test:integration
npm run lint
npm run lint:test
npm run format:check

Use npx --yes -p node@20.19.0 -p npm@10.8.2 npm <command> en estaciones de trabajo donde el tiempo de ejecución de Node predeterminado sea más nuevo que el objetivo del proyecto.

Arquitectura

Mapa de módulos de alto nivel:

src/app.ts: Registro de herramientas MCP y formato de respuesta
src/checker.ts: Sondas de conectividad MCP en vivo con reintento/retroceso
src/registry.ts: Rutas de lectura/escritura de SQLite para servidores, verificaciones y registros de canalizaciones
src/db.ts + src/migrations.ts: Configuración de conexión y actualizaciones de esquema
src/server-http.ts + src/mcp.ts: Puntos de entrada HTTP y stdio
src/scheduler.ts: Bucle de verificación automática en segundo plano opcional

Más detalles en architecture.md.

Hoja de ruta

La planificación detallada de hitos se encuentra en ROADMAP.md.

[x] v1.0: Monitoreo central, tiempo de actividad, alertas, canalizaciones de Azure, informes en Markdown
[ ] v1.1: Notificaciones de webhook para Slack, Discord y puntos finales personalizados
[ ] v1.2: Canalizaciones de múltiples proveedores y monitoreo HTTP genérico
[ ] v2.0: Almacenamiento de PAT cifrado y soporte multiusuario

Seguridad

Lea SECURITY.md para informar vulnerabilidades y docs/security.md para detalles de almacenamiento específicos de la implementación.

Contribución

Consulte contributing.md para la configuración, los estándares y las expectativas de PR.

Licencia

MIT

MCP Health Monitor