CloudWatch Logs MCP Server
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 prefixregion
(optional): AWS regionaccessKeyId
(optional): AWS access key IDsecretAccessKey
(optional): AWS secret access keysessionToken
(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 grouplogStreamName
(optional): The name of the log streamstartTime
(optional): Start time in ISO format or relative time (e.g., “5m”, “1h”, “1d”)endTime
(optional): End time in ISO formatfilterPattern
(optional): Filter pattern for the logsregion
(optional): AWS regionaccessKeyId
(optional): AWS access key IDsecretAccessKey
(optional): AWS secret access keysessionToken
(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": "<YOUR_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
},
"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:
{
"mcpServers": {
"cloudwatch-logs": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"AWS_ACCESS_KEY_ID",
"-e",
"AWS_SECRET_ACCESS_KEY",
"mcp/cloudwatch-logs"
],
"env": {
"AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
"AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
}
}
}
}
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:
list_groups
: Lists available CloudWatch log groupsget_logs
: Reads log entries from specific log groups
Each tool is implemented as an async function decorated with @mcp.tool()
. The server uses the boto3 library to interact with the AWS CloudWatch Logs API.
License
MIT
CloudWatch Logs
Project Details
- serkanh/cloudwatch-logs-mcp
- Last Updated: 4/14/2025
Categories
Recomended MCP Servers
BurpSuite MCP Server: A powerful Model Context Protocol (MCP) server implementation for BurpSuite, providing programmatic access to Burp's...
Add Obsidian integrations like semantic search and custom Templater prompts to Claude or any MCP client.
Claude can perform Web Search | Exa with MCP (Model Context Protocol)
QMT-MCP-Server
Linear MCP Server
A MCP server for Vertex AI Search
A lightweight Model Context Protocol (MCP) server that enables natural language interaction with your Todoist tasks directly from...
A specialized server implementation for the Model Context Protocol (MCP) designed to integrate with CircleCI's development workflow. This...
Monorepo providing 1) OpenAPI to MCP Tool generator 2) Exposing all of Twilio's API as MCP Tools
MCP server for Delve debugger integration
A multi-tool MCP server implementation for agent tool management.