Seq MCP 서버

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

특징

도구

신호 관리

• get-signals - 필터링 옵션을 사용하여 신호 가져오기
  • 소유자 ID로 필터링
  • 공유/개인 신호 필터링
  • 부분 일치 지원

이벤트 관리

• get-events - 광범위한 필터링 옵션을 사용하여 이벤트 검색
  • 신호 ID로 필터링
  • 사용자 정의 필터 표현식
  • 구성 가능한 이벤트 수(최대 100개)
  • 유연한 시간 범위 옵션
  • 날짜 범위 필터링

경보 관리

• get-alertstate - 현재 알림 상태 검색

자원

신호 목록

• signals - 자세한 정보와 함께 공유된 모든 신호를 나열합니다.
  • 신호 ID
  • 제목
  • 설명
  • 공유 상태
  • 소유자 정보

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

• SEQ_BASE_URL (선택 사항): Seq 서버 URL(기본값은 ' http://localhost:8080 ')
• SEQ_API_KEY (필수): Seq API 키

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

지엑스피1

개발

종속성 설치:

서버를 빌드하세요:

자동 재빌드를 사용한 개발의 경우:

테스트 실행:

시간 범위 옵션

get-events 도구는 다음과 같은 시간 범위 옵션을 지원합니다.

• 1m - 마지막 순간
• 15m - 마지막 15분
• 30m - 마지막 30분
• 1h - 마지막 시간
• 2h - 지난 2시간
• 6h - 지난 6시간
• 12h - 지난 12시간
• 1d - 마지막 날
• 7d - 지난 7일
• 14d - 지난 14일
• 30d - 지난 30일

설치

이 도구는 아직 개발 중이며 npm 저장소에 푸시하지 않았습니다. 로컬 저장소에 이 저장소를 복제한 후 npm run build 빌드해야 합니다.

Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.

MacOS의 경우: ~/Library/Application Support/Claude/claude_desktop_config.json Windows의 경우: %APPDATA%/Claude/claude_desktop_config.json

디버깅

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

유형 안전

서버는 다음을 사용하여 포괄적인 유형 안전성을 구현합니다.

• 정적 유형 검사를 위한 TypeScript
• 런타임 유형 검사를 위한 Zod 스키마 검증
• 적절한 오류 처리 및 응답 형식 =======