awslabs.cloudwatch-mcp-server 0.0.3__py3-none-any.whl → 0.0.6__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.6
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
@@ -23,7 +23,7 @@ Classifier: Programming Language :: Python :: 3.13
23
23
  Requires-Python: >=3.10
24
24
  Requires-Dist: boto3>=1.38.22
25
25
  Requires-Dist: loguru>=0.7.0
26
- Requires-Dist: mcp[cli]>=1.6.0
26
+ Requires-Dist: mcp[cli]>=1.11.0
27
27
  Requires-Dist: pydantic>=2.10.6
28
28
  Description-Content-Type: text/markdown
29
29
 
@@ -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,26 @@ 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
+
94
+ #### One Click Install
93
95
 
94
- Example for Amazon Q Developer CLI (~/.aws/amazonq/mcp.json):
96
+ | Cursor | VS Code |
97
+ |:------:|:-------:|
98
+ | [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](https://cursor.com/install-mcp?name=awslabs.cloudwatch-mcp-server&config=ewogICAgImF1dG9BcHByb3ZlIjogW10sCiAgICAiZGlzYWJsZWQiOiBmYWxzZSwKICAgICJjb21tYW5kIjogInV2eCBhd3NsYWJzLmNsb3Vkd2F0Y2gtbWNwLXNlcnZlckBsYXRlc3QiLAogICAgImVudiI6IHsKICAgICAgIkFXU19QUk9GSUxFIjogIltUaGUgQVdTIFByb2ZpbGUgTmFtZSB0byB1c2UgZm9yIEFXUyBhY2Nlc3NdIiwKICAgICAgIkZBU1RNQ1BfTE9HX0xFVkVMIjogIkVSUk9SIgogICAgfSwKICAgICJ0cmFuc3BvcnRUeXBlIjogInN0ZGlvIgp9) | [![Install on VS Code](https://img.shields.io/badge/Install_on-VS_Code-FF9900?style=flat-square&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=CloudWatch%20MCP%20Server&config=%7B%22autoApprove%22%3A%5B%5D%2C%22disabled%22%3Afalse%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22awslabs.cloudwatch-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22AWS_PROFILE%22%3A%22%5BThe%20AWS%20Profile%20Name%20to%20use%20for%20AWS%20access%5D%22%2C%22FASTMCP_LOG_LEVEL%22%3A%22ERROR%22%7D%2C%22transportType%22%3A%22stdio%22%7D) |
95
99
 
100
+ #### MCP Config (Q CLI, Cline)
101
+ * For Q CLI, update MCP Config Amazon Q Developer CLI (~/.aws/amazonq/mcp.json)
102
+ * For Cline click on "Configure MCP Servers" option from MCP tab
96
103
  ```json
97
104
  {
98
105
  "mcpServers": {
99
106
  "awslabs.cloudwatch-mcp-server": {
100
107
  "autoApprove": [],
101
108
  "disabled": false,
102
- "timeout": 60,
103
109
  "command": "uvx",
104
110
  "args": [
105
111
  "awslabs.cloudwatch-mcp-server@latest"
@@ -116,20 +122,18 @@ Example for Amazon Q Developer CLI (~/.aws/amazonq/mcp.json):
116
122
 
117
123
  Please reference [AWS documentation](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) to create and manage your credentials profile
118
124
 
119
- ### Build and install docker image locally on the same host of your LLM client
125
+ ### Option 2: Docker Image
126
+ #### Prerequisites
127
+ Build and install docker image locally on the same host of your LLM client
128
+ 1. Install [Docker](https://docs.docker.com/desktop/)
129
+ 2. `git clone https://github.com/awslabs/mcp.git`
130
+ 3. Go to sub-directory `cd src/cloudwatch-mcp-server/`
131
+ 4. Run `docker build -t awslabs/cloudwatch-mcp-server:latest .`
120
132
 
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
- ```
133
+ #### One Click Cursor Install
134
+ [![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
135
 
136
+ #### MCP Config using Docker image(Q CLI, Cline)
133
137
  ```json
134
138
  {
135
139
  "mcpServers": {
@@ -139,8 +143,8 @@ AWS_SESSION_TOKEN=<from the profile you set up>
139
143
  "run",
140
144
  "--rm",
141
145
  "--interactive",
142
- "--env-file",
143
- "/full/path/to/file/above/.env",
146
+ "-v ~/.aws:/root/.aws",
147
+ "-e AWS_PROFILE=[The AWS Profile Name to use for AWS access]",
144
148
  "awslabs/cloudwatch-mcp-server:latest"
145
149
  ],
146
150
  "env": {},
@@ -150,8 +154,12 @@ AWS_SESSION_TOKEN=<from the profile you set up>
150
154
  }
151
155
  }
152
156
  ```
153
- NOTE: Your credentials will need to be kept refreshed from your host
157
+ Please reference [AWS documentation](https://docs.aws.amazon.com/cli/v1/userguide/cli-configure-files.html) to create and manage your credentials profile
154
158
 
155
159
  ## Contributing
156
160
 
157
- Contributions are welcome! Please see the [CONTRIBUTING.md](../../CONTRIBUTING.md) in the monorepo root for guidelines.
161
+ Contributions are welcome! Please see the [CONTRIBUTING.md](https://github.com/awslabs/mcp/blob/main/CONTRIBUTING.md) in the monorepo root for guidelines.
162
+
163
+ ## Feedback and Issues
164
+
165
+ 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.6.dist-info/METADATA,sha256=5u9rJbRvLKQI-EBsu16oz1BF3a8l60nbq8TLTBRgDL8,9526
13
+ awslabs_cloudwatch_mcp_server-0.0.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
14
+ awslabs_cloudwatch_mcp_server-0.0.6.dist-info/entry_points.txt,sha256=u8YZn3_qq9Ai7nRux17K6K7RDssOBhTSyUNyZKrQUIk,92
15
+ awslabs_cloudwatch_mcp_server-0.0.6.dist-info/licenses/LICENSE,sha256=CeipvOyAZxBGUsFoaFqwkx54aPnIKEtm9a5u2uXxEws,10142
16
+ awslabs_cloudwatch_mcp_server-0.0.6.dist-info/licenses/NOTICE,sha256=xpvRUSHqG7LIpUZ1W_0D4sfPJG8lj51X6Mxjq1KJ6eQ,97
17
+ awslabs_cloudwatch_mcp_server-0.0.6.dist-info/RECORD,,