Log Analyzer
A Model Context Protocol server that provides AI assistants access to AWS CloudWatch Logs, enabling browsing, searching, summarizing, and correlating logs across multiple AWS services.
What is Log Analyzer?
Log Analyzer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that provides ai assistants access to aws cloudwatch logs, enabling browsing, searching, summarizing, and correlating logs across multiple aws services.
A Model Context Protocol server that provides AI assistants access to AWS CloudWatch Logs, enabling browsing, searching, summarizing, and correlating logs across multiple AWS services.
This server falls under the Monitoring & Observability category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that provides AI assistants
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx log-analyzer-with-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Log Analyzer
Log Analyzer with MCP is a Python-based MCP server built by AWS Labs that gives AI assistants direct access to AWS CloudWatch Logs. It lets you browse log groups, run CloudWatch Logs Insights queries, identify error patterns, and correlate log events across multiple AWS services — all through natural language in Claude or Amazon Q CLI. Teams investigating production incidents can ask Claude to summarize recent errors or trace a request across services without leaving the chat interface.
Prerequisites
- Python runtime with uv/uvx installed (https://github.com/astral-sh/uv)
- AWS account with CloudWatch Logs data
- AWS credentials configured locally (via ~/.aws/credentials, environment variables, or an IAM role)
- Claude Desktop, Amazon Q CLI, or another MCP-compatible client
Install uv
The server is run via uvx, which is bundled with the uv Python package manager. Install uv if you do not already have it.
curl -LsSf https://astral.sh/uv/install.sh | shConfigure AWS credentials
The server uses the standard AWS SDK credential chain. Ensure your credentials are configured before starting the server. You can use a named profile or environment variables.
aws configure
# or export AWS_PROFILE=my-profileAdd the server to Claude Desktop config
Open your Claude Desktop configuration file and add the cw-mcp-server entry. The server is fetched directly from the GitHub repository via uvx — no separate install step is needed. Optional: add --profile and --region arguments.
{
"mcpServers": {
"cw-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/awslabs/Log-Analyzer-with-MCP",
"cw-mcp-server"
]
}
}
}Restart Claude Desktop
After saving the config file, restart Claude Desktop so it picks up the new MCP server. The server will launch automatically when Claude starts.
Verify the connection
Open Claude Desktop and ask it to list your CloudWatch Log Groups. A successful response confirms the server is running and AWS credentials are valid.
Log Analyzer Examples
Client configuration
Add this block to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows). To target a specific region or AWS profile, append --region and --profile arguments.
{
"mcpServers": {
"cw-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/awslabs/Log-Analyzer-with-MCP",
"cw-mcp-server",
"--region",
"us-east-1"
]
}
}
}Prompts to try
Once connected, use natural language to explore and analyze your CloudWatch logs.
- "List all CloudWatch Log Groups in my account"
- "Search /aws/lambda/my-function logs for ERROR messages in the last 2 hours"
- "Run a Logs Insights query to count error types in /ecs/my-service over the past day"
- "Summarize the most recent exceptions in my API Gateway access logs"
- "Correlate errors across /aws/lambda/order-service and /aws/lambda/payment-service from the last 30 minutes"Troubleshooting Log Analyzer
Server fails to start with 'uvx: command not found'
Install uv first: curl -LsSf https://astral.sh/uv/install.sh | sh, then open a new terminal session so the PATH is updated before restarting Claude Desktop.
AWS credentials not found or access denied errors when querying logs
Run 'aws sts get-caller-identity' to verify your credentials work. If using a profile, add '--profile', 'your-profile-name' to the args array in the MCP config. Ensure the IAM user or role has cloudwatch:GetLogGroupFields, logs:FilterLogEvents, and logs:StartQuery permissions.
Claude cannot see the cw-mcp-server tools after restart
Check the config file for JSON syntax errors (trailing commas, missing quotes). On macOS, the config path is ~/Library/Application Support/Claude/claude_desktop_config.json. Fully quit and reopen Claude Desktop rather than just closing the window.
Frequently Asked Questions about Log Analyzer
What is Log Analyzer?
Log Analyzer is a Model Context Protocol (MCP) server that model context protocol server that provides ai assistants access to aws cloudwatch logs, enabling browsing, searching, summarizing, and correlating logs across multiple aws services. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Log Analyzer?
Follow the installation instructions on the Log Analyzer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Log Analyzer?
Log Analyzer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Log Analyzer free to use?
Yes, Log Analyzer is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Log Analyzer Alternatives — Similar Monitoring & Observability Servers
Looking for alternatives to Log Analyzer? Here are other popular monitoring & observability servers you can use with Claude, Cursor, and VS Code.
Netdata
★ 78.9kReal-time infrastructure monitoring with metrics, logs, alerts, and ML-based anomaly detection.
Kubeshark
★ 11.9keBPF-powered network observability for Kubernetes. Indexes L4/L7 traffic with full K8s context, decrypts TLS without keys. Queryable by AI agents via MCP and humans via dashboard.
Mission Control
★ 4.9kSelf-hosted AI agent orchestration platform: dispatch tasks, run multi-agent workflows, monitor spend, and govern operations from one mission control dashboard.
Grafana
★ 3.0kThis MCP server enables natural-language querying of Grafana logs by automatically detecting log sources and service labels. It provides read-only access to log data with intelligent caching for efficient repeat queries.
Sentrux
★ 2.4kReal-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improvement of code quality. Pure Rust.
OpenInference
★ 986OpenTelemetry Instrumentation for AI Observability
Browse More Monitoring & Observability MCP Servers
Explore all monitoring & observability servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Log Analyzer in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Log Analyzer?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.