Amazon CloudWatch Logs MCP Server

- Create, describe, and delete log groups
- Create, describe, and delete log streams
- Write log events to a log stream
- Retrieve log events from a log stream
- Search log events with a filter pattern across groups and streams

To use the MCP server, you need to configure it with your AWS credentials. You can do this by setting environment variables:

{
  "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>"
      }
    }
  }
}

> Note: In the future, this project will be published as an npm package and as a Docker image for easier installation and usage.

pnpm install

- Docker
- Visual Studio Code
- VS Code Dev Containers extension

1. Clone the repository:

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

2. Open the project in VS Code:

   code .
   

3. When prompted, click "Reopen in Container" or use the command palette and select "Dev Containers: Reopen in Container".

4. VS Code will build the dev container and open the project inside it. This may take a few minutes the first time.

5. Once inside the container, the development environment is fully set up with all dependencies installed.

| Tool Name | Description |
| -------------------- | ---------------------------------------------------------------------------------------- |
| create_log_group | Creates a new Amazon CloudWatch Logs log group |
| describe_log_groups | List and describe Amazon CloudWatch Logs log groups |
| delete_log_group | Delete an Amazon CloudWatch Logs log group |
| create_log_stream | Create a new log stream in an Amazon CloudWatch Logs log group |
| describe_log_streams | List and describe log streams in an Amazon CloudWatch Logs log group |
| delete_log_stream | Delete a log stream in an Amazon CloudWatch Logs log group |
| put_log_events | Write log events to a specified log stream in Amazon CloudWatch Logs |
| get_log_events | Retrieve log events from a specified log stream in Amazon CloudWatch Logs |
| filter_log_events | Search log events with a pattern across log groups and streams in Amazon CloudWatch Logs |

For detailed documentation on each tool, including parameters and examples, see TOOLS.md.

> Note: This project is under development. Additional CloudWatch Logs operations are planned for future releases.