🚀 亚马逊云日志MCP服务器
该项目是一个用于与亚马逊云（Amazon Cloud）日志服务交互的MCP（模型上下文协议）服务器。它允许AI助手通过标准化接口访问和管理CloudWatch日志资源，包括创建、查询和删除日志组、日志流及相关事件。
🚀 快速开始
本项目是用于与亚马逊云日志服务交互的MCP服务器，可帮助AI助手通过标准化接口管理CloudWatch日志资源。下面为你介绍如何安装该项目。
📦 安装指南
1. 使用npm包
npm install amazon-cloudwatch-logs-mcp-server
2. 使用Docker镜像
拉取镜像：
docker pull ghcr.io/your-org/amazon-cloudwatch-logs-mcp-server:latest
运行容器：
docker run -it --rm ghcr.io/your-org/amazon-cloudwatch-logs-mcp-server:latest
3. 本地构建
克隆仓库：
git clone https://github.com/hyorimitsu/mcp-amazon-cloudwatch-logs.git
cd mcp-amazon-cloudwatch-logs
npm install
运行服务：
node index.js
📚 详细文档
环境变量
基本配置
| 变量名 | 描述 | 示例值 |
|---|---|---|
| AWS_REGION | 亚马逊区域 | "us-east-1" |
| AWS_ACCESS_KEY | 访问密钥 | "AKIAXXXXXXXXXXXXXXXX" |
| AWS_SECRET_KEY | 秘钥 | "XXXXXXXXXXXXXXXXXXXXXXXX" |
只读模式
设置READONLY为"true"以启用只读模式：
READONLY=true
功能概述
日志组操作
- 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：启动CloudWatch Insights查询。
- stop_query：停止正在运行的查询。
- get_query_results：获取指定查询的结果。
- describe_queries：列出所有或特定状态的查询任务。
开发指南
如需贡献代码或扩展功能，请参考CONTRIBUTING.md。
📄 许可证
本项目采用MIT许可证，详情请见LICENSE文件。