MCP Cloudwatch Tracker

🚀 雲Watch日誌跟蹤器

雲Watch日誌跟蹤器是一個用於對AWS CloudWatch日誌進行分析和調試的MCP（模型上下文協議）服務器，能幫助用戶高效地從日誌中獲取關鍵信息。

🚀 快速開始

雲Watch日誌跟蹤器可助力您對AWS CloudWatch日誌進行高效分析與調試。您可按如下步驟快速開啟使用。

✨ 主要特性

• 從CloudWatch日誌組中搜索特定字符串
• 查看日誌前後上下文
• 日誌分析結果摘要
• 錯誤日誌分析及原因排查

📦 安裝指南

使用NPX運行

npx -y @juri-dev-lab/mcp-cloudwatch-tracker@latest \
  --aws-access-key-id 您的 AWS 訪問密鑰 ID \
  --aws-secret-access-key 您的 AWS 密鑰\
  --aws-region 您的 AWS 區域

使用Docker運行

# 從 Docker Hub 下載鏡像
docker pull juridevlab/mcp-cloudwatch-tracker

# 設置環境變量並運行
docker run --rm -i \
  -e AWS_ACCESS_KEY_ID=您的 AWS 訪問密鑰 ID \
  -e AWS_SECRET_ACCESS_KEY=您的 AWS 密鑰\
  -e AWS_REGION=您的 AWS 區域 \
  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

2. 使用系統環境變量

export AWS_ACCESS_KEY_ID=您的 AWS 訪問密鑰 ID
export AWS_SECRET_ACCESS_KEY=您的 AWS 密鑰\
export AWS_REGION=ap-northeast-2

3. 使用AWS CLI配置憑證

aws configure

⚠️ 重要提示

• 使用.env文件時，請務必將其添加到.gitignore中。
• 切勿將AWS憑證包含在源代碼或版本控制系統中。
• 請使用各自獨立的AWS賬戶憑證。
• 建議生產環境使用AWS IAM角色。

推薦的IAM策略

訪問CloudWatch日誌所需的最小權限策略：

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

💻 使用示例

基礎用法

搜索日誌

# 搜索包含關鍵字的條目
$ tracker search --keyword "關鍵詞" --log-group /var/log/myapp.log

# 按條件篩選日誌
$ tracker filter --start-time "2023-10-01" --end-time "2023-10-02"

查看最近日誌

# 查看最新的 10 條日誌
$ tracker latest --limit 10

📚 詳細文檔

開發環境設置

克隆代碼庫

git clone https://github.com/your-repository/mcp-cloudwatch-tracker.git
cd mcp-cloudwatch-tracker

安裝依賴項

npm install

運行服務器

node index.js

測試

單元測試

npm test

監視模式

npm run watch

📄 許可證

MIT