logicmonitor-mcp

LogicMonitor MCP server: expone la API REST de LogicMonitor (v3, /santaba/rest) como herramientas MCP.

Descripción general

Este servidor implementa el Model Context Protocol (transporte Streamable HTTP/SSE) y envuelve los endpoints de LogicMonitor utilizados por la propia integración de LogicMonitor de MSPbots. Sigue el SOP de Servicio MCP de Proveedores de MSPbots: sin estado, sin credenciales almacenadas, autenticación por cabecera en cada solicitud.

La API subyacente se autentica mediante LMv1 — una firma HMAC-SHA256 por solicitud calculada a partir de un par Access Id / Access Key (el mismo esquema que MSPbots usa para esta integración: Company + Access Id + Access Key, sin OAuth). Este servidor calcula la firma LMv1 por sí mismo para cada solicitud saliente a partir de las credenciales suministradas en las cabeceras de esa solicitud; nunca las persiste.

Related MCP server: databricks-mcp

Inicio rápido

Docker (recomendado)

docker compose up --build

El servidor se inicia en http://localhost:8080.

Local (uv)

uv sync
python -m logicmonitor_mcp

Comprobación de salud

curl http://localhost:8080/health
# {"status": "ok"}

No se requieren credenciales para el endpoint de salud.

Parámetros de autenticación

Cada solicitud a /mcp debe incluir las siguientes cabeceras HTTP:

Si falta cualquiera de las tres cabeceras, se devuelve 401 Unauthorized.

Variables de entorno

logicmonitor-mcp no tiene variables de entorno obligatorias: toda la identidad (company/access id/access key) se envía por solicitud mediante cabeceras.

Endpoint MCP

POST http://localhost:8080/mcp

Conecta tu cliente MCP con:

• Transporte: http (Streamable HTTP / SSE)

• Cabeceras: X-LogicMonitor-Company, X-LogicMonitor-Access-Id, X-LogicMonitor-Access-Key (todas obligatorias)

Lista de herramientas

15 herramientas — que coinciden con los 15 endpoints de la API de LogicMonitor ya registrados en esta integración en MSPbots (sys_integration subject_code LOGICMONITOR), de modo que la cobertura de herramientas es coherente con el alcance existente de MSPbots. Todas las herramientas son de solo lectura (readOnlyHint=True); no hay herramientas de escritura/eliminación en este servicio.

Paginación: size tiene un valor predeterminado de 50 y se limita en el servidor a un máximo estricto de 1000 — el máximo documentado/aplicado por LogicMonitor para este parámetro (los valores superiores a 1000 se limitan silenciosamente por LogicMonitor; solicitar más nunca genera error, solo devuelve como máximo 1000). Independientemente de eso, cualquier respuesta de una herramienta está limitada a 20 000 caracteres; si una página de resultados lo excediera, la respuesta se trunca con los campos truncated/original_count en lugar de devolverse completa.

Dispositivos (3)

DataSources de dispositivos (4)

Alertas (3)

Administración (2)

Informes (2)

SDT (1)

Manejo de errores

Los errores de las herramientas se devuelven como una cadena JSON (no como una excepción a nivel de protocolo), de modo que un Agente pueda tomar decisiones programáticamente:

{"error": {"code": "upstream_error", "message": "...", "retryable": true}}

code es uno de un vocabulario fijo: not_configured, unauthorized, not_found, invalid_argument, rate_limited, upstream_error. retryable indica si la misma llamada es segura de reintentar (true para rate_limited/upstream_error, false en caso contrario).

Robustez de red

• Tiempos de espera de salida: conexión 5s / lectura 30s / escritura 10s / pool 5s.

• Reintentos limitados (hasta 3 intentos) con retroceso exponencial limitado en 429/5xx, respetando Retry-After cuando está presente.

• Cada intento de reintento recalcula la firma LMv1 desde cero (incluye la época actual), por lo que una solicitud reintentada nunca se envía con una firma obsoleta/expirada.

• Se reutiliza un único pool de conexiones httpx.AsyncClient compartido durante toda la vida del proceso.

Ejemplo de prueba

Listar dispositivos:

{
  "method": "tools/call",
  "params": { "name": "logicmonitor_get_devices", "arguments": { "size": 10 } }
}

curl equivalente contra el servidor en ejecución (endpoint MCP HTTP streamable):

curl -X POST http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "X-LogicMonitor-Company: <company>" \
  -H "X-LogicMonitor-Access-Id: <access_id>" \
  -H "X-LogicMonitor-Access-Key: <access_key>" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": { "name": "logicmonitor_get_devices", "arguments": { "size": 10 } }
  }'

Una llamada parametrizada:

{
  "method": "tools/call",
  "params": {
    "name": "logicmonitor_get_device_datasources",
    "arguments": { "device_id": "7186" }
  }
}

Referencia de API

• Documentación oficial: LogicMonitor REST API v3

• Esquema de autenticación: LMv1 API Tokens

• Patrón de URL base: https://{company}.logicmonitor.com/santaba/rest

Brechas conocidas / No verificado aún

• Aún no se ha probado contra un portal de LogicMonitor en vivo; solo se ha realizado verificación a nivel de protocolo (comprobación de salud, 401 con cabeceras faltantes/parciales, tools/list que devuelve las 15 herramientas, mapeo de códigos de error probado con unit tests).

• La cobertura de herramientas coincide intencionalmente con las 15 entradas de API de LogicMonitor existentes en MSPbots, en lugar de la superficie completa de la API REST de LogicMonitor (que además cubre operaciones de escritura, paneles, sitios web, coleccionistas y LogicModules); se puede ampliar si se necesita una cobertura más amplia.