mcp-cloudwatch-tracker
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 ์๊ฒฉ ์ฆ๋ช ์ ์ค์ ํ์ธ์:
- .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