Amazon CloudWatch Logs MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Amazon CloudWatch Logs 服务交互的工具。该服务器使 AI 助手能够通过使用 AWS SDK 的标准化接口来管理 CloudWatch 日志。

注意： 该项目目前正在积极开发中，尚未准备好用于生产环境。在第一个稳定版本发布之前，功能和 API 可能会发生重大变化。

概述

该 MCP 服务器允许 AI 助手通过模型上下文协议与 Amazon CloudWatch Logs 交互。它提供了一个标准化的接口，用于执行各种 CloudWatch Logs 操作，从而实现对日志数据的全面管理和监控。

设置

使用本地开发构建

# 克隆仓库
git clone https://github.com/hyorimitsu/mcp-amazon-cloud-watch-logs.git
cd mcp-amazon-cloud-watch-logs

# 安装依赖
pnpm install

# 构建项目
pnpm run build

配置

要使用 MCP 服务器，您需要使用您的 AWS 凭证对其进行配置。您可以通过设置环境变量来完成此操作：

{
  "mcpServers": {
    "amazon-cloudwatch-logs": {
      "command": "node",
      "args": ["/path/to/mcp-amazon-cloud-watch-logs/build/index.js"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

注意： 将来，该项目将作为 npm 包和 Docker 镜像发布，以便于安装和使用。

可用工具

工具名称	描述
create_log_group	创建一个新的 Amazon CloudWatch Logs 日志组
describe_log_groups	列出和描述 Amazon CloudWatch Logs 日志组
delete_log_group	删除一个 Amazon CloudWatch Logs 日志组
create_log_stream	在 Amazon CloudWatch Logs 日志组中创建一个新的日志流
describe_log_streams	列出和描述 Amazon CloudWatch Logs 日志组中的日志流
delete_log_stream	删除 Amazon CloudWatch Logs 日志组中的一个日志流

有关每个工具的详细文档，包括参数和示例，请参阅 TOOLS.md。

注意： 该项目正在开发中。计划在未来的版本中添加其他 CloudWatch Logs 操作。

开发

该项目使用 VS Code Dev Containers 进行开发，以确保所有贡献者拥有一致的开发环境。

开发先决条件

• Docker
• Visual Studio Code
• VS Code Dev Containers 扩展

开发设置

1. 克隆仓库：

   git clone https://github.com/hyorimitsu/mcp-amazon-cloud-watch-logs.git
   cd mcp-amazon-cloud-watch-logs
   

2. 在 VS Code 中打开项目：

   code .
   

3. 出现提示时，单击“Reopen in Container”或使用命令面板并选择“Dev Containers: Reopen in Container”。

4. VS Code 将构建开发容器并在其中打开项目。 第一次可能需要几分钟。

5. 进入容器后，开发环境已完全设置，并安装了所有依赖项。

开发命令

所有命令都在开发容器内运行：

# 构建项目
pnpm run build

# 运行 linter
pnpm run lint

# 修复 lint 问题
pnpm run lint:fix

# 格式化代码
pnpm run format

# 使用 MCP Inspector 进行测试
pnpm run inspector

扩展服务器

该服务器设计为易于扩展。 要添加新的 CloudWatch Logs 操作：

1. 在 src/operations/schemas/ 中创建一个 schema
2. 在 src/operations/ 中实现该操作
3. 将工具定义添加到 src/handlers/tools/types.ts
4. 将该工具添加到 src/handlers/tools/tools.ts 中的工具列表

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。