CloudWatch LogsSAFE

An MCP (Model Context Protocol) server that provides tools for accessing AWS CloudWatch logs. This server allows AI assistants to list log groups and read log entries from AWS CloudWatch.

Available Tools

list_groups

Lists available CloudWatch log groups.

Parameters:

• prefix (optional): Log group name prefix
• region (optional): AWS region
• accessKeyId (optional): AWS access key ID
• secretAccessKey (optional): AWS secret access key
• sessionToken (optional): AWS session token

Returns: JSON string with the list of log groups, including logGroupName, creationTime, and storedBytes.

get_logs

Gets CloudWatch logs from a specific log group.

Parameters:

• logGroupName (required): The name of the log group
• logStreamName (optional): The name of the log stream
• startTime (optional): Start time in ISO format or relative time (e.g., "5m", "1h", "1d")
• endTime (optional): End time in ISO format
• filterPattern (optional): Filter pattern for the logs
• region (optional): AWS region
• accessKeyId (optional): AWS access key ID
• secretAccessKey (optional): AWS secret access key
• sessionToken (optional): AWS session token

Returns: JSON string with the log events, including timestamp, message, and logStreamName.

Setup

AWS Credentials

Ensure you have AWS credentials configured. You can set them up using the AWS CLI or by setting environment variables:

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

{
"mcpServers": {
"cloudwatch-logs": {
"command": "python3",
"args": ["/path/to/cloudwatch-logs-mcp/main.py"],
"env": {
"AWS_ACCESS_KEY_ID": "",
"AWS_SECRET_ACCESS_KEY": "",
},
"disabled": false,
"autoApprove": []
}
}
}

Docker

If you prefer to run the serv