awslabs.cloudwatch-mcp-server 0.0.3__py3-none-any.whl → 0.0.5__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: awslabs.cloudwatch-mcp-server
3
- Version: 0.0.3
3
+ Version: 0.0.5
4
4
  Summary: An AWS Labs Model Context Protocol (MCP) server for cloudwatch
5
5
  Project-URL: homepage, https://awslabs.github.io/mcp/
6
6
  Project-URL: docs, https://awslabs.github.io/mcp/servers/cloudwatch-mcp-server/
@@ -8,7 +8,7 @@ Project-URL: documentation, https://awslabs.github.io/mcp/servers/cloudwatch-mcp
8
8
  Project-URL: repository, https://github.com/awslabs/mcp.git
9
9
  Project-URL: changelog, https://github.com/awslabs/mcp/blob/main/src/cloudwatch-mcp-server/CHANGELOG.md
10
10
  Author: Amazon Web Services
11
- Author-email: AWSLabs MCP <203918161+awslabs-mcp@users.noreply.github.com>, Isaiah Lemmon <ilemmon@amazon.com>
11
+ Author-email: AWSLabs MCP <203918161+awslabs-mcp@users.noreply.github.com>, Isaiah Lemmon <ilemmon@amazon.com>, Shrikant Tambe <tshrikan@amazon.com>, Gianluca Cacace <cacaceg@amazon.com>, Andrea Giuliano <aggiulia@amazon.com>, Goran Modrusa <goran@amazon.com>
12
12
  License: Apache-2.0
13
13
  License-File: LICENSE
14
14
  License-File: NOTICE
@@ -46,13 +46,10 @@ Metric Definition Analyzer - Provides comprehensive descriptions of what metrics
46
46
  Alarm Recommendations - Suggests recommended alarm configurations for CloudWatch metrics, including thresholds, evaluation periods, and other alarm settings.
47
47
 
48
48
  ## Prerequisites
49
-
50
- 1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) or the [GitHub README](https://github.com/astral-sh/uv#installation)
51
- 2. Install Python using `uv python install 3.10`
52
- 3. An AWS account with [CloudWatch Telemetry](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)
53
- 4. This MCP server can only be run locally on the same host as your LLM client.
54
- 5. Set up AWS credentials with access to AWS services
55
- - You need an AWS account with appropriate permissions
49
+ 1. An AWS account with [CloudWatch Telemetry](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)
50
+ 2. This MCP server can only be run locally on the same host as your LLM client.
51
+ 3. Set up AWS credentials with access to AWS services
52
+ - You need an AWS account with appropriate permissions (See required permissions below)
56
53
  - Configure AWS credentials with `aws configure` or environment variables
57
54
 
58
55
  ## Available Tools
@@ -89,17 +86,23 @@ Alarm Recommendations - Suggests recommended alarm configurations for CloudWatch
89
86
 
90
87
  ## Installation
91
88
 
92
- [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://www.cursor.com/install-mcp?name=awslabs.cloudwatch-mcp-server&config=eyJhdXRvQXBwcm92ZSI6W10sImRpc2FibGVkIjpmYWxzZSwidGltZW91dCI6NjAsImNvbW1hbmQiOiJ1dnggYXdzbGFicy5jbG91ZHdhdGNoLW1jcC1zZXJ2ZXJAbGF0ZXN0IiwiZW52Ijp7IkFXU19QUk9GSUxFIjoiW1RoZSBBV1MgUHJvZmlsZSBOYW1lIHRvIHVzZSBmb3IgQVdTIGFjY2Vzc10iLCJBV1NfUkVHSU9OIjoiW1RoZSBBV1MgcmVnaW9uIHRvIHJ1biBpbl0iLCJGQVNUTUNQX0xPR19MRVZFTCI6IkVSUk9SIn0sInRyYW5zcG9ydFR5cGUiOiJzdGRpbyJ9)
89
+ ### Option 1: Python (UVX)
90
+ #### Prerequisites
91
+ 1. Install `uv` from [Astral](https://docs.astral.sh/uv/getting-started/installation/) or the [GitHub README](https://github.com/astral-sh/uv#installation)
92
+ 2. Install Python using `uv python install 3.10`
93
93
 
94
- Example for Amazon Q Developer CLI (~/.aws/amazonq/mcp.json):
94
+ #### One Click Cursor Install
95
+ [![Install CloudWatch MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://www.cursor.com/install-mcp?name=awslabs.cloudwatch-mcp-server&config=ewogICAgImF1dG9BcHByb3ZlIjogW10sCiAgICAiZGlzYWJsZWQiOiBmYWxzZSwKICAgICJjb21tYW5kIjogInV2eCBhd3NsYWJzLmNsb3Vkd2F0Y2gtbWNwLXNlcnZlckBsYXRlc3QiLAogICAgImVudiI6IHsKICAgICAgIkFXU19QUk9GSUxFIjogIltUaGUgQVdTIFByb2ZpbGUgTmFtZSB0byB1c2UgZm9yIEFXUyBhY2Nlc3NdIiwKICAgICAgIkZBU1RNQ1BfTE9HX0xFVkVMIjogIkVSUk9SIgogICAgfSwKICAgICJ0cmFuc3BvcnRUeXBlIjogInN0ZGlvIgp9)
95
96
 
97
+ #### MCP Config (Q CLI, Cline)
98
+ * For Q CLI, update MCP Config Amazon Q Developer CLI (~/.aws/amazonq/mcp.json)
99
+ * For Cline click on "Configure MCP Servers" option from MCP tab
96
100
  ```json
97
101
  {
98
102
  "mcpServers": {
99
103
  "awslabs.cloudwatch-mcp-server": {
100
104
  "autoApprove": [],
101
105
  "disabled": false,
102
- "timeout": 60,
103
106
  "command": "uvx",
104
107
  "args": [
105
108
  "awslabs.cloudwatch-mcp-server@latest"
@@ -116,20 +119,18 @@ Example for Amazon Q Developer CLI (~/.aws/amazonq/mcp.json):
116
119
 
117
120
  Please reference [AWS documentation](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) to create and manage your credentials profile
118
121
 
119
- ### Build and install docker image locally on the same host of your LLM client
122
+ ### Option 2: Docker Image
123
+ #### Prerequisites
124
+ Build and install docker image locally on the same host of your LLM client
125
+ 1. Install [Docker](https://docs.docker.com/desktop/)
126
+ 2. `git clone https://github.com/awslabs/mcp.git`
127
+ 3. Go to sub-directory `cd src/cloudwatch-mcp-server/`
128
+ 4. Run `docker build -t awslabs/cloudwatch-mcp-server:latest .`
120
129
 
121
- 1. `git clone https://github.com/awslabs/mcp.git`
122
- 2. Go to sub-directory 'src/cloudwatch-mcp-server/'
123
- 3. Run 'docker build -t awslabs/cloudwatch-mcp-server:latest .'
124
-
125
- ### Add or update your LLM client's config with following:
126
- ```file
127
- # fictitious `.env` file with AWS temporary credentials
128
- AWS_ACCESS_KEY_ID=<from the profile you set up>
129
- AWS_SECRET_ACCESS_KEY=<from the profile you set up>
130
- AWS_SESSION_TOKEN=<from the profile you set up>
131
- ```
130
+ #### One Click Cursor Install
131
+ [![Install CloudWatch MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://www.cursor.com/install-mcp?name=awslabs.cloudwatch-mcp-server&config=ewogICAgICAgICJjb21tYW5kIjogImRvY2tlciIsCiAgICAgICAgImFyZ3MiOiBbCiAgICAgICAgICAicnVuIiwKICAgICAgICAgICItLXJtIiwKICAgICAgICAgICItLWludGVyYWN0aXZlIiwKICAgICAgICAgICItZSBBV1NfUFJPRklMRT1bVGhlIEFXUyBQcm9maWxlIE5hbWVdIiwKICAgICAgICAgICJhd3NsYWJzL2Nsb3Vkd2F0Y2gtbWNwLXNlcnZlcjpsYXRlc3QiCiAgICAgICAgXSwKICAgICAgICAiZW52Ijoge30sCiAgICAgICAgImRpc2FibGVkIjogZmFsc2UsCiAgICAgICAgImF1dG9BcHByb3ZlIjogW10KfQ==)
132
132
 
133
+ #### MCP Config using Docker image(Q CLI, Cline)
133
134
  ```json
134
135
  {
135
136
  "mcpServers": {
@@ -139,8 +140,8 @@ AWS_SESSION_TOKEN=<from the profile you set up>
139
140
  "run",
140
141
  "--rm",
141
142
  "--interactive",
142
- "--env-file",
143
- "/full/path/to/file/above/.env",
143
+ "-v ~/.aws:/root/.aws",
144
+ "-e AWS_PROFILE=[The AWS Profile Name to use for AWS access]",
144
145
  "awslabs/cloudwatch-mcp-server:latest"
145
146
  ],
146
147
  "env": {},
@@ -150,8 +151,12 @@ AWS_SESSION_TOKEN=<from the profile you set up>
150
151
  }
151
152
  }
152
153
  ```
153
- NOTE: Your credentials will need to be kept refreshed from your host
154
+ Please reference [AWS documentation](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) to create and manage your credentials profile
154
155
 
155
156
  ## Contributing
156
157
 
157
- Contributions are welcome! Please see the [CONTRIBUTING.md](../../CONTRIBUTING.md) in the monorepo root for guidelines.
158
+ Contributions are welcome! Please see the [CONTRIBUTING.md](https://github.com/awslabs/mcp/blob/main/CONTRIBUTING.md) in the monorepo root for guidelines.
159
+
160
+ ## Feedback and Issues
161
+
162
+ We value your feedback! Submit your feedback, feature requests and any bugs at [GitHub issues](https://github.com/awslabs/mcp/issues) with prefix `cloudwatch-mcp-server` in title.
@@ -9,9 +9,9 @@ awslabs/cloudwatch_mcp_server/cloudwatch_logs/tools.py,sha256=0uyB5n8qw0PpGSGV9v
9
9
  awslabs/cloudwatch_mcp_server/cloudwatch_metrics/models.py,sha256=ov6aJUUrN2fz9Gom-tE4DT5h6M0PCkKwA9pEBnVv6SE,5756
10
10
  awslabs/cloudwatch_mcp_server/cloudwatch_metrics/tools.py,sha256=GoW0gLy35gW7MspbxtfNBghUgR8xWIa4tgcohqYE1h8,33410
11
11
  awslabs/cloudwatch_mcp_server/cloudwatch_metrics/data/metric_metadata.json,sha256=FlSUlfYVo1VdANrsBg50atggMNGSqZvhhZU7ca-v48c,745055
12
- awslabs_cloudwatch_mcp_server-0.0.3.dist-info/METADATA,sha256=eAQkMwKsUjkiQ-JCdr_PxHIo_t8OJmxUr9g8sBEe8uw,7750
13
- awslabs_cloudwatch_mcp_server-0.0.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
14
- awslabs_cloudwatch_mcp_server-0.0.3.dist-info/entry_points.txt,sha256=u8YZn3_qq9Ai7nRux17K6K7RDssOBhTSyUNyZKrQUIk,92
15
- awslabs_cloudwatch_mcp_server-0.0.3.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
16
- awslabs_cloudwatch_mcp_server-0.0.3.dist-info/licenses/NOTICE,sha256=xpvRUSHqG7LIpUZ1W_0D4sfPJG8lj51X6Mxjq1KJ6eQ,97
17
- awslabs_cloudwatch_mcp_server-0.0.3.dist-info/RECORD,,
12
+ awslabs_cloudwatch_mcp_server-0.0.5.dist-info/METADATA,sha256=3jUqoIPMizF-X9_cW2FPxkEL2Fp2__0JIJfzu1oRyts,8935
13
+ awslabs_cloudwatch_mcp_server-0.0.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
14
+ awslabs_cloudwatch_mcp_server-0.0.5.dist-info/entry_points.txt,sha256=u8YZn3_qq9Ai7nRux17K6K7RDssOBhTSyUNyZKrQUIk,92
15
+ awslabs_cloudwatch_mcp_server-0.0.5.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
16
+ awslabs_cloudwatch_mcp_server-0.0.5.dist-info/licenses/NOTICE,sha256=xpvRUSHqG7LIpUZ1W_0D4sfPJG8lj51X6Mxjq1KJ6eQ,97
17
+ awslabs_cloudwatch_mcp_server-0.0.5.dist-info/RECORD,,