mcp-amazon-cloudwatch-logs

🚀 亚马逊云日志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文件。