logicmonitor-mcp

LogicMonitor MCP 服务器 — 将 LogicMonitor REST API (v3, /santaba/rest) 暴露为 MCP 工具。

概述

该服务器实现了 Model Context Protocol（Streamable HTTP/SSE 传输），并封装了 MSPbots 自身 LogicMonitor 集成所使用的 LogicMonitor 端点。它遵循 MSPbots Vendor MCP Service SOP：无状态、不存储凭据、按请求进行头部认证。

底层 API 通过 LMv1 进行认证 — 这是一种基于 Access Id / Access Key 对计算的每次请求 HMAC-SHA256 签名（与 MSPbots 自身用于此集成的方案相同：Company + Access Id + Access Key，无 OAuth）。该服务器根据请求头中提供的凭据，为每个出站请求自行计算 LMv1 签名；它从不持久化这些凭据。

Related MCP server: databricks-mcp

快速开始

Docker（推荐）

docker compose up --build

服务器启动于 http://localhost:8080。

本地（uv）

uv sync
python -m logicmonitor_mcp

健康检查

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

健康检查端点不需要任何凭据。

授权参数说明 (Authentication)

Every request to /mcp must include the following HTTP headers:

Missing any of the three headers returns 401 Unauthorized.

环境变量

logicmonitor-mcp 没有必需的环境变量 — 所有身份信息（company/access id/access key）均通过请求头按请求提供。

MCP 端点

POST http://localhost:8080/mcp

使用以下方式连接你的 MCP 客户端：

• 传输方式：http（Streamable HTTP / SSE）

• 请求头：X-LogicMonitor-Company、X-LogicMonitor-Access-Id、X-LogicMonitor-Access-Key（均为必填）

工具列表

15 个工具 — 与 MSPbots 中此集成下已注册的 15 个 LogicMonitor API 端点（sys_integration subject_code LOGICMONITOR）相匹配，因此工具覆盖范围与 MSPbots 现有范围一致。所有工具均为只读（readOnlyHint=True）；本服务不包含任何写入/删除工具。

分页：size 默认为 50，服务端会将其硬性限制为 1000 — 这是 LogicMonitor 自身文档规定/强制执行的该参数最大值（超过 1000 的值会被 LogicMonitor 静默截断；请求更多不会报错，只是最多返回 1000 条）。除此之外，任何单个工具响应上限为 20,000 个字符 — 如果一页结果超过该限制，响应将被截断，并带有 truncated/original_count 字段，而不是完整返回。

设备（3）

设备数据源（4）

告警（3）

管理（2）

报表（2）

SDT（1）

错误处理

工具错误以 JSON 字符串形式返回（而非协议级异常），因此 Agent 可以以编程方式根据它进行分支处理：

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

code 是固定词汇表之一：not_configured、unauthorized、not_found、invalid_argument、rate_limited、upstream_error。retryable 表示同一调用是否可安全重试（对于 rate_limited/upstream_error 为 true，否则为 false）。

网络健壮性

• 出站超时：连接 5 秒 / 读取 30 秒 / 写入 10 秒 / 连接池 5 秒。

• 有限重试（最多 3 次），在 429/5xx 上采用有上限的指数退避，并遵循 Retry-After（如果存在）。

• 每次重试都会从头重新计算 LMv1 签名（其中嵌入了当前时间戳），因此重试的请求绝不会使用过期/失效的签名发送。

• 进程生命周期内复用单个共享的 httpx.AsyncClient 连接池。

测试示例 (Test Example)

列出设备：

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

针对运行中的服务器（streamable HTTP MCP 端点）的等效 curl 命令：

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 } }
  }'

参数化调用：

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

API 参考

• 官方文档：LogicMonitor REST API v3

• 认证方案：LMv1 API Tokens

• 基础 URL 模式：https://{company}.logicmonitor.com/santaba/rest

已知差距 / 尚未验证

• 尚未针对真实的 LogicMonitor 门户进行测试 — 目前仅完成了协议级验证（健康检查、缺少/部分请求头时返回 401、tools/list 返回全部 15 个工具、单元测试的错误码映射）。

• 工具覆盖范围有意与 MSPbots 现有的 15 个已注册 LogicMonitor API 条目保持一致，而非完整的 LogicMonitor REST API 表面（后者还涵盖写操作、仪表板、网站、采集器和 LogicModules）— 如需更广泛的覆盖，可按请求扩展。