mcp-cloudwatch-tracker

mcp-cloudwatch-tracker

3.1

If you are the rightful owner of mcp-cloudwatch-tracker and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

AWS CloudWatch ๋กœ๊ทธ๋ฅผ ๋ถ„์„ํ•˜๊ณ  ๋””๋ฒ„๊น…ํ•˜๊ธฐ ์œ„ํ•œ MCP(Model Context Protocol) ์„œ๋ฒ„์ž…๋‹ˆ๋‹ค.

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 ์ž๊ฒฉ ์ฆ๋ช…์„ ์„ค์ •ํ•˜์„ธ์š”:

  1. .env ํŒŒ์ผ ์‚ฌ์šฉ (๊ฐœ๋ฐœ ํ™˜๊ฒฝ ๊ถŒ์žฅ)
# ํ”„๋กœ์ ํŠธ ๋ฃจํŠธ์— .env ํŒŒ์ผ ์ƒ์„ฑ
AWS_ACCESS_KEY_ID=your_access_key
AWS_SECRET_ACCESS_KEY=your_secret_key
AWS_REGION=ap-northeast-2
  1. ์‹œ์Šคํ…œ ํ™˜๊ฒฝ ๋ณ€์ˆ˜ ์‚ฌ์šฉ
export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=ap-northeast-2
  1. 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

๊ฐœ๋ฐœ ํ™˜๊ฒฝ ์„ค์ •

  1. ์ €์žฅ์†Œ ํด๋ก 
git clone https://github.com/juri-dev-lab/mcp-cloudwatch-tracker.git
cd mcp-cloudwatch-tracker
  1. ์˜์กด์„ฑ ์„ค์น˜
npm install
  1. ๊ฐœ๋ฐœ ์„œ๋ฒ„ ์‹คํ–‰
npm run dev
  1. Docker ์ด๋ฏธ์ง€ ๋นŒ๋“œ ๋ฐ ์‹คํ–‰
# ์ด๋ฏธ์ง€ ๋นŒ๋“œ
npm run docker:build

# ์ด๋ฏธ์ง€ ์‹คํ–‰
npm run docker:run

ํ…Œ์ŠคํŠธ

# ๋‹จ์œ„ ํ…Œ์ŠคํŠธ ์‹คํ–‰
npm test

# ํ…Œ์ŠคํŠธ ๊ฐ์‹œ ๋ชจ๋“œ
npm run test:watch

๋ผ์ด์„ ์Šค

MIT