mcp-cloudwatch-tracker

Name: mcp-cloudwatch-tracker
Author: Juri-Dev-Lab

本地服务

github.com/Juri-Dev-Lab云与基础设施082 周前更新

代码仓库

关于 mcp-cloudwatch-tracker

mcp-cloudwatch-tracker 是用于分析和调试 AWS CloudWatch 日志的 MCP 服务，可搜索日志组、查看上下文并总结分析结果及错误。

主要功能

01搜索 CloudWatch 日志组
02查看日志前后文
03总结日志分析结果
04分析错误及原因

适用场景

01在 CloudWatch 日志中搜索字符串
02查看匹配日志附近的事件
03调查错误日志及可能原因

MCP 相关

它向 MCP 客户端提供 AWS CloudWatch 日志搜索与分析功能。

#mcp-cloudwatch-tracker #log-tracking #aws-cloudwatch

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudwatch-tracker": {
      "command": "npx",
      "args": [
        "-y",
        "@juri-dev-lab/mcp-cloudwatch-tracker"
      ]
    }
  }
}

启动命令npx -y @juri-dev-lab/mcp-cloudwatch-tracker

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@juri-dev-lab/mcp-cloudwatch-trackerstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

README 原文English

来自项目 README

README 暂无中文译文，以下为英文原文；中文介绍见上方。

CloudWatch Log Tracker

AWS CloudWatch 로그를 분석하고 디버깅하기 위한 MCP(Model Context Protocol) 서버입니다.

주요 기능

CloudWatch 로그 그룹에서 특정 문자열 검색
로그의 전후 컨텍스트 조회
로그 분석 결과 요약
에러 로그 분석 및 원인 파악

설치 및 실행 방법

NPX를 통한 실행

npx -y @juri-dev-lab/mcp-cloudwatch-tracker@latest \
  --aws-access-key-id YOUR_AWS_ACCESS_KEY \
  --aws-secret-access-key YOUR_AWS_SECRET_KEY \
  --aws-region YOUR_AWS_REGION

Docker를 통한 실행

# Docker Hub에서 이미지 가져오기
docker pull juridevlab/mcp-cloudwatch-tracker

# 환경 변수와 함께 실행
docker run --rm -i \
  -e AWS_ACCESS_KEY_ID=YOUR_AWS_ACCESS_KEY \
  -e AWS_SECRET_ACCESS_KEY=YOUR_AWS_SECRET_KEY \
  -e AWS_REGION=YOUR_AWS_REGION \
  juridevlab/mcp-cloudwatch-tracker

AWS 자격 증명 설정

다음 방법 중 하나를 선택하여 AWS 자격 증명을 설정하세요:

.env 파일 사용 (개발 환경 권장)

# 프로젝트 루트에 .env 파일 생성
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
AWS_REGION=ap-northeast-2

시스템 환경 변수 사용

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=ap-northeast-2

AWS CLI 자격 증명 사용

aws configure

⚠️ 보안 주의사항:

.env 파일을 사용할 경우 반드시 .gitignore에 추가하세요
AWS 자격 증명을 절대 소스 코드나 버전 관리에 포함하지 마세요
각자 자신의 AWS 계정 자격 증명을 사용해야 합니다
프로덕션 환경에서는 AWS IAM 역할 사용을 권장합니다

권장 IAM 정책

CloudWatch 로그 접근을 위한 최소 권한 IAM 정책:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:GetLogEvents",
        "logs:FilterLogEvents",
        "logs:DescribeLogGroups",
        "logs:DescribeLogStreams"
      ],
      "Resource": "arn:aws:logs:*:*:*"
    }
  ]
}

사용 예시

로그 검색

# 기본 검색
cloudwatch-log-tracker search -g your-log-group -s your-stream -t "search-term"

# 상세 옵션 사용
cloudwatch-log-tracker search \
  -g your-log-group \
  -s your-stream \
  -t "search-term" \
  -d 7 \  # 검색할 일 수
  -c 5 \  # 전후 컨텍스트 라인 수
  --analyze-errors  # 에러 분석 수행

최근 로그 조회

# 기본 조회
cloudwatch-log-tracker recent -g your-log-group -s your-stream

# 조회 개수 지정
cloudwatch-log-tracker recent -g your-log-group -s your-stream -l 50

개발 환경 설정

저장소 클론

git clone https://github.com/juri-dev-lab/mcp-cloudwatch-tracker.git
cd mcp-cloudwatch-tracker

의존성 설치

npm install

개발 서버 실행

npm run dev

Docker 이미지 빌드 및 실행

# 이미지 빌드
npm run docker:build

# 이미지 실행
npm run docker:run

테스트

# 단위 테스트 실행
npm test

# 테스트 감시 모드
npm run test:watch

라이선스

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。