serkanh/cloudwatch-logs-mcp

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
### listgroups
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.
### getlogs
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:
AWSACCESSKEYID
AWSSECRETACCESSKEY
### Usage with Claude Desktop
Add the following to your claudedesktopconfig.json:
json
"mcpServers": {
"cloudwatch-logs": {
"command": "python3",
"args": ["/path/to/cloudwatch-logs-mcp/main.py"],
"env": {
"AWSACCESSKEYID": " ",
"AWSSECRETACCESSKEY": " ",
},
"disabled": false,
"autoApprove": []
### Docker
If you prefer to run the server in a Docker container, you can set up a Dockerfile and use the following configuration:
json
"mcpServers": {
"cloudwatch-logs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AWSACCESSKEYID",
"-e",
"AWSSECRETACCESSKEY",
"mcp/cloudwatch-logs"
],
"env": {
"AWSACCESSKEYID": " ",
"AWSSECRETACCESSKEY": " ",
## Implementation Details
This server is built using the FastMCP class from the MCP SDK, which provides a simple way to create MCP servers. The server exposes two main tools: