Amazon CloudWatch Logs MCP Server
2025.04.22
0
TypeScript日志管理日志分析监控与告警其它
Amazon CloudWatch Logs MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于与 Amazon CloudWatch Logs 服务进行交互。它通过标准化的接口，使 AI 助手能够通过 AWS SDK 管理 CloudWatch 日志。该服务目前处于积极开发阶段，尚未准备好用于生产环境。
View on GitHub
Overview
基本能力
产品定位
Amazon CloudWatch Logs MCP Server 是一个中间件服务，旨在为 AI 助手提供与 Amazon CloudWatch Logs 交互的标准接口。
核心功能
- 日志组操作：创建、描述和删除日志组。
- 日志流操作：创建、描述和删除日志流。
- 日志事件操作：上传、获取和过滤日志事件。
- Insights 操作：启动、停止查询，获取查询结果和描述查询。
适用场景
- 日志管理：自动化管理 CloudWatch 日志组和日志流。
- 日志分析：通过 CloudWatch Logs Insights 进行日志查询和分析。
- 监控与告警：集成到监控系统中，实时处理日志数据。
工具列表
- create_log_group：创建日志组。
- describe_log_groups：列出日志组。
- delete_log_group：删除日志组。
- create_log_stream：创建日志流。
- describe_log_streams：列出日志流。
- delete_log_stream：删除日志流。
- put_log_events：上传日志事件。
- get_log_events：获取日志事件。
- filter_log_events：过滤日志事件。
- start_query：启动查询。
- stop_query：停止查询。
- get_query_results：获取查询结果。
- describe_queries：描述查询。
常见问题解答
- 如何启用只读模式？ 通过设置
READONLY环境变量为"true"可以启用只读模式，此时仅允许读取操作。 - 支持哪些 AWS 区域？ 默认区域为
us-east-1，可以通过AWS_REGION环境变量指定其他区域。
使用教程
使用依赖
- AWS 账户：需要有 CloudWatch Logs 访问权限的 AWS 账户。
- AWS 访问密钥：需要提供
AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY。 - Node.js 或 Docker：根据安装方式选择。
安装教程
选项 1: npm 安装
npm install -g @hyorimitsu/amazon-cloudwatch-logs-mcp-server
选项 2: Docker 安装
docker pull ghcr.io/hyorimitsu/mcp-amazon-cloudwatch-logs:latest
选项 3: 本地开发构建
git clone https://github.com/hyorimitsu/mcp-amazon-cloudwatch-logs.git
cd mcp-amazon-cloudwatch-logs
pnpm install
pnpm run build
调试方式
- 配置环境变量：确保
AWS_REGION、AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY正确设置。 - 运行服务：根据安装方式运行服务，检查日志输出是否有错误。
- 测试工具：使用提供的工具进行测试，如
describe_log_groups查看日志组列表。