Log Analyzer with CloudWatch Logs

by awslabs

4 stars
316 downloads
Not rated
GitHub

About

Provides structured access to CloudWatch Logs data for searching, analyzing, and correlating logs across AWS services to help with troubleshooting and pattern identification.

Details

Author
awslabs
Repository
awslabs/Log-Analyzer-with-MCP
GitHub stars
4
Downloads
316
License
Apache License 2.0
Categories
Developer Tools, Design, Workplace, AI, Search, Cloud Service, Communication, Infrastructure, Frontend

- Browse and search CloudWatch Log Groups
- Search logs using CloudWatch Logs Insights query syntax
- Generate log summaries and identify error patterns
- Correlate logs across multiple AWS services
- AI-optimized tools for assistants like Claude

Detailed feature list

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Log Analyzer with CloudWatch Logs
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 -y
    • Argument 2 @highlight/mcp-server

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

1. Make sure to have configured your AWS credentials as described here

2. Update your claude_desktop_config.json file with the proper configuration outlined in the AI integration guide

3. Open Claude for Desktop and start chatting!

For more examples and advanced usage, see the detailed usage guide.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "log analyzer with cloudwatch logs": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

Log Analyzer with MCP

A Model Context Protocol (MCP) server that provides AI assistants access to AWS CloudWatch Logs for analysis, searching, and correlation.

🏗️ Architecture

Architecture Diagram

🔌 Model Context Protocol (MCP)

As outlined by Anthropic:
> MCP is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications. Just as USB-C provides a standardized way to connect your devices to various peripherals and accessories, MCP provides a standardized way to connect AI models to different data sources and tools.

This repository is an example client and server that allows an AI assistant like Claude to interact with CloudWatch logs in an AWS account. To learn more about MCP, read through the introduction.

✨ Features

- Browse and search CloudWatch Log Groups
- Search logs using CloudWatch Logs Insights query syntax
- Generate log summaries and identify error patterns
- Correlate logs across multiple AWS services
- AI-optimized tools for assistants like Claude

Detailed feature list

🚀 Installation

Prerequisites

- The uv Python package and project manager (includes uvx)
- An AWS account with CloudWatch Logs
- Configured AWS credentials

🚦 Quick Start

1. Make sure to have configured your AWS credentials as described here

2. Update your claude_desktop_config.json file with the proper configuration outlined in the AI integration guide

3. Open Claude for Desktop and start chatting!

For more examples and advanced usage, see the detailed usage guide.

🤖 AI Integration

This project can be easily integrated with AI assistants like Claude for Desktop. See the AI integration guide for details.

📚 Documentation

- Detailed Features
- Usage Guide
- AWS Configuration
- Architecture Details
- AI Integration
- Troubleshooting

🔒 Security

See CONTRIBUTING for more information.

📄 License

This project is licensed under the Apache-2.0 License.2a:["$","div",null,{"classNa

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.