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 サーバーです。ロググループを検索し、前後の文脈を取得して、分析結果やエラーを要約します。

主な機能

01CloudWatch ロググループの検索
02ログ前後のコンテキスト取得
03ログ分析結果の要約
04エラーと原因の分析

活用シーン

01CloudWatch ログ内の文字列検索
02一致したログ周辺のイベント確認
03エラーログと原因候補の調査

MCP 対応

AWS CloudWatch のログ検索と分析機能を MCP クライアントに公開します。

#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 サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。