WinLog-mcp

🪟 WinLog-mcp

Windows 이벤트 로그(예: 애플리케이션, 시스템, 보안)를 검색하고 분석하는 모델 컨텍스트 프로토콜(MCP) 도구입니다. WinLog-mcp는 Windows 이벤트 로그를 수집하고 쿼리할 수 있는 프로그래밍 방식의 액세스를 제공하므로 보안 모니터링, 사고 대응 및 로그 분석 자동화에 이상적입니다.

⚠️ 경고: 이 도구는 관리자 권한으로 실행해야 합니다. 시스템에 의도치 않은 변경이 발생하지 않도록 주의하세요.

✨ 특징

• Windows Sysmon 로그를 수집하여 사용자 정의 디렉토리에 파일로 저장합니다.
• 타임스탬프별로 로그 쿼리 , 분석 또는 문제 해결을 위한 최근 이벤트 항목 반환
• MCP 도구 및 생태계와의 원활한 상호 운용성

📄 로그 파일 형식

• 로그 파일은 선택한 저장 경로에서 <timestamp>_<log_type>.log 형식으로 이름이 지정됩니다.

MCP 서버(도구, 프롬프트,...)

🛠️ 사용 가능한 도구

• ingest_syslog : 최근 Sysmon 로그를 수집하여 파일에 기록합니다.
• query_syslog : 타임스탬프로 수집된 로그를 쿼리하고 최근 이벤트를 반환합니다.

📋 요구 사항

• 운영 체제: 윈도우
• 파이썬: 3.7 이상
• 종속성:
  • 파이윈32
  • mcp.server.fastmcp (또는 MCP 서버 구현)

💾 설치

저장소를 복제하고 종속성을 설치합니다.

지엑스피1

🚀 사용법

🖥️ Sysmon 설치

참고: Sysmon 설치 지침

▶️ 직접 실행

MCP 서버로 도구를 실행합니다.

🧑‍💻 개발 모드

MCP Inspector를 사용하여 검사하거나 디버깅할 수 있습니다.

⚙️ 구성

winlog-mcp 도구를 실행하기 위한 MCP 구성.

🤖 MCP 클라이언트 통합

💬 Claude 데스크톱 통합

구성 파일은 다음 위치에 있습니다.

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Desktop과 통합하면 Claude에게 다음 작업을 요청할 수 있습니다.

지난 24시간 동안의 마지막 10개 이벤트를 보여주시고 분석해 주세요.

📄 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.