Skip to main content
Glama
Seq MCP Server

Seq MCP Server

by ahmad2x4

Seq MCP 서버

로깅 및 모니터링 시스템과 상호작용하기 위한 Seq API 엔드포인트용 MCP 서버입니다. 이 서버는 Model Context Protocol을 통해 Seq의 API 기능에 대한 포괄적인 액세스를 제공합니다.

기능

도구

신호 관리

  • get_signals - 필터링 옵션을 사용하여 신호 가져오기

    • 소유자 ID별 필터링

    • 공유/개인 신호 필터링

    • 부분 일치 지원

이벤트 관리

  • get_events - 광범위한 필터링 옵션을 사용하여 이벤트 검색

    • 신호 ID별 필터링

    • 사용자 지정 필터 표현식

    • 구성 가능한 이벤트 수(최대 50개)

    • 유연한 시간 범위 옵션

    • 날짜 범위 필터링

경고 관리

  • get_alert_state - 경고의 현재 상태 검색

리소스

신호 목록

  • signals - 상세 정보가 포함된 모든 공유 신호 나열

    • 신호 ID

    • 제목

    • 설명

    • 공유 상태

    • 소유자 정보

Related MCP server: Overwatch MCP

구성

이 서버는 다음 환경 변수가 필요합니다:

  • SEQ_BASE_URL (선택 사항): Seq 서버 URL (기본값: 'http://localhost:8080')

  • SEQ_API_KEY (필수): Seq API 키

seq-ops 스킬

이 저장소에는 Seq 로그 분석 및 사고 조사를 위한 Claude 스킬이 포함되어 있습니다. MCP 서버가 연결되면 이 스킬은 구조화된 조사(상태 점검, 사고 분류, 배포 후 모니터링)를 통해 Claude를 안내하고 일관되고 실행 가능한 보고서를 생성합니다.

스킬 설치:

# From the releases page, download seq-ops.skill, then:
claude skill install seq-ops.skill

또는 이 저장소에서 직접 설치:

npx skills add ahmad2x4/mcp-server-seq

이 스킬은 "아침 상태 점검", "운영 환경에 문제가 있음", "타임아웃 로그 확인" 또는 "PPSR 통합 조사"와 같은 질문을 하면 자동으로 활성화됩니다.


Claude Code와 함께 사용

다음 명령을 실행하여 서버를 추가합니다:

claude mcp add --transport stdio \
  --env SEQ_BASE_URL=http://localhost:5341 \
  --env SEQ_API_KEY=your-api-key \
  seq -- npx -y mcp-seq

팀과 구성을 공유하려면 --scope project 플래그를 사용하세요(.mcp.json에 저장됨):

claude mcp add --transport stdio --scope project \
  --env SEQ_BASE_URL=http://localhost:5341 \
  --env SEQ_API_KEY=your-api-key \
  seq -- npx -y mcp-seq

Windows 사용자: "Connection closed" 오류를 방지하려면 npx -y mcp-seq를 cmd /c npx -y mcp-seq로 바꾸세요.

Claude Code 내에서 /mcp를 실행하여 서버가 연결되었는지 확인합니다.

Claude Desktop과 함께 사용

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "seq": {
      "command": "npx",
      "args": ["-y", "mcp-seq"],
      "env": {
        "SEQ_BASE_URL": "your-seq-url",
        "SEQ_API_KEY": "your-api-key"
      }
    }
  }
}

개발

종속성 설치:

npm install

서버 빌드:

npm run build

자동 재빌드를 포함한 개발:

npm run dev

테스트 실행:

npm run test-script

시간 범위 옵션

get-events 도구는 다음 시간 범위 옵션을 지원합니다:

  • 1m - 지난 1분

  • 15m - 지난 15분

  • 30m - 지난 30분

  • 1h - 지난 1시간

  • 2h - 지난 2시간

  • 6h - 지난 6시간

  • 12h - 지난 12시간

  • 1d - 지난 1일

  • 7d - 지난 7일

  • 14d - 지난 14일

  • 30d - 지난 30일

설치

npm을 통해 전역 설치:

npm install -g mcp-seq

또는 npx와 함께 직접 사용(위의 구성 예시와 같이 별도의 설치 불필요).

디버깅

MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 서버는 모든 작업에 대해 적절한 오류 처리 및 로깅을 구현합니다. 테스트 스크립트를 실행하여 기능을 확인할 수 있습니다:

npm run test-script

타입 안전성

이 서버는 다음을 사용하여 포괄적인 타입 안전성을 구현합니다:

  • 정적 타입 검사를 위한 TypeScript

  • 런타임 타입 검사를 위한 Zod 스키마 유효성 검사

  • 적절한 오류 처리 및 응답 형식 지정

Available Tools

3 tools
get-alertstateD

Inputs: no named parameters.

get-eventsB

Retrieve and analyze a list of event filtered by parameters. Use this tool when you need to:

  • Investigate events that are being logged in the SEQ server

  • Details of each event is a structured log and can provide usefull information

  • Events could be information, error, debug, or critical

  • Analyze error patterns and frequencies

Inputs: signal, filter, count, fromDateUtc, +2 more.

get-signalsD

Inputs: ownerId, shared, partial.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    D1.9/5.0

    Scored across 3 tools

    Disambiguation3/5

    The tools appear to target different aspects of a Seq server (alert state, events, signals), but with only one description available for 'get-events', it's unclear how 'get-alertstate' and 'get-signals' differ in purpose. This creates some ambiguity, though the distinct names suggest separate functions.

    Naming Consistency5/5

    All three tools follow a consistent 'get-[noun]' naming pattern using kebab-case, which is predictable and readable. There are no deviations in style or verb usage across the tool set.

    Tool Count2/5

    With only 3 tools, this server feels under-scoped for a logging/monitoring domain like Seq, which typically involves more operations such as creating alerts, filtering logs, or managing signals. The count is too low to cover the apparent scope effectively.

    Completeness2/5

    The tool set is severely incomplete for a Seq server, lacking essential operations like creating or updating alerts, sending logs, or configuring signals. Only read-only 'get' operations are provided, which will limit agents to passive monitoring without the ability to interact or modify the system.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for retrieving and filtering logs from Mezmo with a quota-conscious design and intelligent defaults. It enables users to discover and query logs by application, level, and custom time ranges to streamline debugging while minimizing API usage.
      1
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables querying logs and metrics from Graylog, Prometheus, and InfluxDB 2.x. It provides tools for executing Lucene log searches, PromQL queries, and Flux queries directly within MCP-compatible clients.
      MIT
    • F
      license
      B
      quality
      B
      maintenance
      MCP server that integrates with Sumo Logic's API to perform log searches, data discovery, metrics queries, and monitoring.
      15
      22 npm
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for querying structured logs from Datalust Seq, providing tools to search logs, retrieve recent errors, fetch events, and check health.
      MIT