CloudWatch Logs MCP Server

CloudWatch Logs MCP 서버

AWS CloudWatch 로그에 액세스하는 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 AI 어시스턴트는 로그 그룹을 나열하고 AWS CloudWatch에서 로그 항목을 읽을 수 있습니다.

사용 가능한 도구

목록_그룹

사용 가능한 CloudWatch 로그 그룹을 나열합니다.

매개변수:

• prefix (선택 사항): 로그 그룹 이름 접두사
• region (선택 사항): AWS 지역
• accessKeyId (선택 사항): AWS 액세스 키 ID
• secretAccessKey (선택 사항): AWS 비밀 액세스 키
• sessionToken (선택 사항): AWS 세션 토큰

반환: logGroupName , creationTime , storedBytes 포함한 로그 그룹 목록이 포함된 JSON 문자열입니다.

get_logs

특정 로그 그룹에서 CloudWatch 로그를 가져옵니다.

매개변수:

• logGroupName (필수): 로그 그룹의 이름
• logStreamName (선택 사항): 로그 스트림의 이름
• startTime (선택 사항): ISO 형식의 시작 시간 또는 상대 시간(예: "5m", "1h", "1d")
• endTime (선택 사항): ISO 형식의 종료 시간
• filterPattern (선택 사항): 로그에 대한 필터 패턴
• region (선택 사항): AWS 지역
• accessKeyId (선택 사항): AWS 액세스 키 ID
• secretAccessKey (선택 사항): AWS 비밀 액세스 키
• sessionToken (선택 사항): AWS 세션 토큰

반환: timestamp , message , logStreamName 포함한 로그 이벤트가 포함된 JSON 문자열입니다.

설정

AWS 자격 증명

AWS 자격 증명이 구성되어 있는지 확인하세요. AWS CLI를 사용하거나 환경 변수를 설정하여 설정할 수 있습니다.

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY

Claude Desktop과 함께 사용

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

지엑스피1

도커

Docker 컨테이너에서 서버를 실행하려면 Dockerfile을 설정하고 다음 구성을 사용할 수 있습니다.

구현 세부 사항

이 서버는 MCP SDK의 FastMCP 클래스를 사용하여 구축되었으며, 이를 통해 MCP 서버를 간편하게 생성할 수 있습니다. 이 서버는 두 가지 주요 도구를 제공합니다.

1. list_groups : 사용 가능한 CloudWatch 로그 그룹을 나열합니다.
2. get_logs : 특정 로그 그룹의 로그 항목을 읽습니다.

각 도구는 @mcp.tool() 로 데코레이팅된 비동기 함수로 구현됩니다. 서버는 boto3 라이브러리를 사용하여 AWS CloudWatch Logs API와 상호 작용합니다.

특허

MIT