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许可证。