mcp-server-logs-sieve

mcp-server-logs-sieve는 AI 어시스턴트가 관찰 가능성 백엔드에서 직접 로그를 쿼리할 수 있게 해주는 MCP 서버입니다.

일반 언어로 디버깅 질문을 하면 Logs Sieve가 정확한 로그와 컨텍스트를 가져옵니다.

이 서버가 존재하는 이유

인시던트 발생 시, 다음과 같은 반복적인 작업에 많은 시간이 소요됩니다:

• 올바른 로그 소스 찾기

• 시간 범위 좁히기

• 반복되는 장애 패턴 발견

• 서비스 간 하나의 추적(trace) 따라가기

Logs Sieve는 이러한 워크플로우를 query_logs, summarize_logs, trace_request, list_log_sources라는 네 가지 도구로 패키징합니다.

Related MCP server: Azure Logs MCP

지원되는 공급자

• Google Cloud Logging (gcp)

• AWS CloudWatch Logs (aws)

• Azure Monitor Logs (azure)

• Grafana Loki (loki)

• Elasticsearch (elasticsearch)

필수 조건

⚠️ Node.js 20 이상이 필요합니다.

이 패키지는 Node.js 20+가 필요한 ES 모듈과 종속성을 사용합니다. ERR_MODULE_NOT_FOUND 오류가 발생하면 node -v로 Node 버전을 확인하고 필요시 업그레이드하세요.

이는 npx를 통해 실행하거나, 전역으로 설치하거나, 소스에서 사용할 때 모두 적용됩니다.

빠른 MCP 설정

.mcp.json 예시:

{
  "mcpServers": {
    "logs-sieve": {
      "command": "npx",
      "args": ["-y", "mcp-server-logs-sieve@latest", "--provider", "gcp"]
    }
  }
}

이 저장소 소스에서 직접 실행하는 경우에도 node ./bin/mcp-server-logs-sieve.js --provider gcp를 사용할 수 있습니다.

최초 설정: 처음 사용할 때 npx는 패키지를 다운로드하고 설치해야 합니다(약 40초 소요). Claude Code가 이를 기다리다가 타임아웃될 수 있습니다. MCP 설정에 추가하기 전에 터미널에서 다음을 한 번 실행하여 캐시를 준비하세요:

npx mcp-server-logs-sieve@latest --provider gcp
# (Ctrl+C once it starts — you just need the install to complete)

그 후에는 Claude Code가 npx 캐시에서 즉시 서버를 시작합니다.

설정을 업데이트한 후 MCP 클라이언트를 다시 시작하고 /mcp로 확인하세요.

공급자 인증 및 환경 변수

공급자별 설정 및 인증 문서를 참조하세요:

• GCP

• AWS

• Azure

• Loki

• Elasticsearch

Elasticsearch API 호환성 헤더의 경우:

export ELASTICSEARCH_COMPAT_VERSION=8

CLI 사용법

이 패키지에는 직접 터미널에서 사용할 수 있는 CLI도 포함되어 있습니다:

mcp-server-logs-sieve query --provider gcp --scope my-project --last 1h --filter "payment failed"
mcp-server-logs-sieve summarize --provider gcp --scope my-project --last 24h
mcp-server-logs-sieve trace --provider gcp --scope my-project --trace <trace-id>
mcp-server-logs-sieve sources --provider gcp --scope my-project

문서

• 문서 홈

• 시작하기

• MCP 클라이언트 설정 (Claude Code, Claude Desktop, Cursor, Windsurf)

• 도구 참조

• 문제 해결

• 호환성 매트릭스

기여

기여를 환영합니다.

• 시작하기: CONTRIBUTING.md

• 이슈: https://github.com/Oluwatunmise-olat/mcp-server-logs-sieve/issues

• 토론: https://github.com/Oluwatunmise-olat/mcp-server-logs-sieve/discussions