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를 따릅니다: 무상태(stateless), 자격 증명 저장 없음, 요청별 헤더 인증.

기본 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"}

상태 엔드포인트에는 자격 증명이 필요하지 않습니다.

인증 매개변수 설명

/mcp에 대한 모든 요청에는 다음 HTTP 헤더가 포함되어야 합니다:

세 헤더 중 하나라도 없으면 401 Unauthorized를 반환합니다.

환경 변수

logicmonitor-mcp에는 필수 환경 변수가 없습니다 — 모든 ID(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)

장치 DataSource(4)

알림(3)

관리(2)

보고서(2)

SDT(1)

오류 처리

도구 오류는 프로토콜 수준 예외가 아닌 JSON 문자열로 반환되므로, 에이전트가 프로그래밍 방식으로 분기할 수 있습니다:

{"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초.

• 429/5xx에 대해 제한된 재시도(최대 3회) 및 상한이 있는 지수 백오프, Retry-After가 있으면 이를 준수합니다.

• 각 재시도 시도는 LMv1 서명을 처음부터 다시 계산합니다(현재 epoch를 포함하므로, 재시도된 요청은 만료된 서명으로 전송되지 않습니다).

• 단일 공유 httpx.AsyncClient 연결 풀이 프로세스 수명 동안 재사용됩니다.

테스트 예시

장치 나열:

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

실행 중인 서버에 대한 동등한 curl(streamable HTTP MCP 엔드포인트):

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 토큰

• 기본 URL 패턴: https://{company}.logicmonitor.com/santaba/rest

알려진 격차 / 아직 검증되지 않음

• 아직 실제 LogicMonitor 포털에 대해 테스트되지 않음 — 지금까지는 프로토콜 수준 검증(상태 확인, 헤더 누락/부분 시 401, tools/list가 15개 도구 모두 반환, 단위 테스트된 오류 코드 매핑)만 수행되었습니다.

• 도구 범위는 의도적으로 MSPbots의 기존 15개 등록 LogicMonitor API 항목과 일치하며, 전체 LogicMonitor REST API 표면(쓰기 작업, 대시보드, 웹사이트, 수집기, LogicModule도 포함)과는 다릅니다 — 더 넓은 범위가 필요하면 요청에 따라 확장할 수 있습니다.